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1. Introduction 


1.1. ISIS on the Web — a bit of history 


The particular nature of the creation and development of CDS/ISIS was a prerequisite for 
a close cooperation between developers and users. Thousands of users of the CDS/ISIS 
software, mostly in the library community, share similar needs in data management 
systems; these needs were prominent in pushing the development of DOS, and Windows 
ISIS software, and then Web applications for data management. 


In more than 20 years since its first DOS origin, Micro-CDS ISIS has turned out to be one 
of the main tools for computerizing library catalogues and building information systems 
in thousands of institutions all over the world. Now, there are thousands of databases in 
the ISIS format, run in non-profit organizations, mainly in developing countries, but also 
in many international, governmental, and non-governmental institutions. With those 
thousands of libraries and information centers all around the world there has grown up a 
large and active community of trained librarians and developers, who are used to the 
system and are familiar with the basic system elements, such as, e.g. ISIS formatting 
language, Field Definition Table, Field Select Table, etc., enabling them to design and 
fairly easily implement simple applications. 


Some 10 years ago new needs have emerged, mainly related to the tools for developing 
advanced applications. Many solutions were provided during the last 10 years. Among 
them a leading role was played by BIREME, where ISIS-DLL' has been developed. With 
the tools provided by BIREME it became feasible to develop tools for building advanced 
web-based systems’. Two development lines have started in more or less the same time 


e one at BIREME, resulted with WXIS 


e and another one at ICIE, as a result of the FAO-WAICENT request, at the 
preliminary stage for building tools for AGRIS centers, leading to WWW-ISIS' = 


The collaboration between FAO and ICIE was based on the technical expertise of 
ICIE with close cooperation with programmers from a Polish company CC’, and FAO's 
experience in formulating the user requirements, adapting and developing the applications 
in a multilingual environment. Created originally as a tool for capacity building and for 
distributing FAO information resources on CD-ROM (AGRIS and FAOBIB), very 
quickly it turned out to be useful enough for larger applications at FAO and other 
institutions and Libraries. 


' ISIS-DLL is an “application programmer interface" (API) to the ISIS databases, making 
possible writing advanced applications for the ISIS databases. 


^ Another development line has been started by the OPEN-ISIS group, this had however a 
lesser meaning, probably because the use of the OPEN-ISIS resulted required much more 
advanced expertise. 


* Both, ICIE and CC are small private Polish companies, being kick-off's from Warsaw 
University of Technology 
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The development of the FAOBIB cataloguing system and its OPAC was the driving 
force behind the development of the WWW-ISIS functionalities in 2001. Additionally, 
efforts on the part of the GIL staff to make the WWW-ISIS software reliable and user- 
friendly, even where human resources are scarce, gave rise to the development of the 
WebAgris Information management system as the one of the main tools for 
AGRIS/CARIS resource centres. 


On the request of FAO-WAICENT, in 2002 WWW:-ISIS was subject of further 
development by ICIE and CC. As an outcome of this development, and following the 
successful co-operation between FAO, IFAD and GTZ in the area of information and 
knowledge management, the three organizations have decided to work on a common 
development project of the LOAN system for their libraries. At that time all the three 
organizations were experienced users of the WWW-ISIS based catalogue. In order to 
reduce the development cost and acquire a high level solution for a reasonable investment, 
a dedicated consortium has been set up among the bodies. As a result, the LOAN system 
has been implemented by ICIE according to the functional specification accepted by all 
the three parties. This system has opened possibilities for using WWW-ISIS in building 
more advanced “‘transactional” and “work flow" systems. 


A year after this agreement was finalized, IFAD has additionally decided to develop 
(with WWW-ISIS' ”) an acquisition module, and integrate it with the remaining modules 
(OPAC and LOAN). The work has been performed by ICIE. 


The experience gained, while building and adopting the library applications, first for 
the three organizations, and then for other bodies (ICCROM, WFP, IDLO), made it 
possible to build the library integrated system, which has been named WebLIS. 
Fortunately, UNESCO also recognized that the idea of releasing WebLIS would become 
very important for the entire ISIS community, and as a result, UNESCO has decided to 
support its publication and distribution on their web site. 


In 2006 FAO has decided on integrating WEBLIS with WEBAgris, which resulted in 
a common FAO, САТТЕ and ICIE project, giving rise to a successful library integrated 
system known as LISAGR. LISAGR has been developed for English and Spanish. It 1s 
used by ORTON library in Costa Rica, and requested by many libraries in Latin America. 
Now a final version 1s available for distribution on request. 


In 2007 IFRC has decided to develop French and Spanish versions of WEBLIS in 
order to distribute it to the national Red Cross/Red Crescent organizations. 


The current version of WebLIS and LISAGR consists of: 
e Cataloguing system (English, French, Spanish) 
e OPAC (English, French, Spanish) 
e LOAN subsystem (English, French, Spanish) 
e Acquisition subsystem (English and Spanish) 
e Statistical module (English only). 
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One of the main applications of WWW:-ISIS (since the very beginning) was FAOLEX. 
Since then the system has grown essentially in terms of number of records, languages, 
alphabets, functionalities. Recently FAOLEX has become the main information resource 
of the Ecolex portal (run by FAO, IUCN and UNEP). With these developments the main 
limitations of the current version of ISIS (and in effect WWW-ISIS) have shown up. We 
describe the problems below. 


Problems 


The main disadvantages of the ICIE/CC version of WWW-ISIS resulted mainly from the 
restrictions of the BIREME's ISIS-DLL functionality. In particular ISIS databases, as 
they were, were not UNICODE compliant. This disadvantage drastically restricted 
applications of WWW:-ISIS for multilingual databases, as well as multi-alphabet 
documents, which becomes quite restrictive in the library applications. Yet another 
problem lies in the fact that WWW-ISIS can be currently installed only on the Windows 
platform. To this end in cooperation between Institute of Computer Science (Warsaw 
University of Technology), and the FAO a new software has emerged with the following 
features: 


e The new version of WWW-ISIS is available for both Windows and Linux; 
e The new version of WWW-ISIS is compliant with UNICODE 


The architecture of the current WWW-ISIS consists of two quite well separated groups of 


functions: 


1. the functions that provide access to the ISIS databases, perform ISIS-specific 
operations, like reading a piece of inverted file, formatting a record, updating a 


record or inverted file, etc; the functions use mechanisms provided by ISIS-DLL. 


2. а group of functions which perform WWW-ISIS functionality independently of 
ISIS, e.g. build a search screen, provide a worksheet for the data entry screen, etc. 
These functions may refer to the functions from the first grouping order to receive 


some data from an ISIS database. 


Instead of changing the BIREME's ISIS-DLL which is strongly restricted by some 
concepts, nowadays a bit obsolete (like maximum record length, fixed and old structure of 


b-trees, with fixed length of indexes), we have implemented the new a-ISIS software 
which: 


1. Uses a relational database as a storage of ISIS records, so one column in the 
relational database will be devoted to store “ISIS records”. This approach gives us 
stability of the relational database storage, quick access to indicated record (by 
MEN), and preserves the idea of amorphic flexible ISIS record structure (XML). 
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2. Uses a powerful indexing tool for text retrieval, as a novel ISIS inverted file. In 
this case we use Lucene, which 15 the most successful Open Source text search 
engine. It is also UNICODE compliant; 


3. has a component that is able to interpret ISIS formatting language, within the 
scope used in the current WWW -ISIS, additionally with the functions REF and 
lookup; 


So one can see “ISIS” only via РЕТ and FST, whereas the rest is SQL database + Lucene. 
SQL database could be Postgres, or SQLite. The database 1s used as just a database engine 
for storing *ISIS-like" records. Its “relational database features" would be not used at all, 
except for transactionality. In the very first look there is one table in the database 
composed of record ID and a field (column) where an XML form of ISIS record is stored. 
This gives us a powerful all transactional advantages of Postgres and its reliability (much 
higher than old ISIS), and all the advantages of Lucene (including search and Unicode). 
Hence the system 1s based on 


1. НТР files (as it is now) 
2. Database.def, browse.def, entry.def (as 1t is now) 


3. formatting language, which is the main tool for defining display pages, FST, 
validation formats and validation tables (as it 15 now) 


The API for the SQL DB+Lucene ISIS (LucISIS) covers basic operations on records 
(accessed by МЕМ), formatting with the PFI, updating inverted file (this will be 
controlled by FST), accessing a portion of the inverted file (for browsing). The FST will 
cover techniques О and 8, and possibly some more resulting from the Lucene possibilities. 


1.2. Functions of a-WWW-ISIS 


The system can perform the following functions: 


Browse 

Search from a form 

Search cross a number of ISIS databases’ 

Search with the ISIS query language! 

Keep history queries and use them in the search formulation! 
Thesaurus based search 

Data entry (access to the authority databases, full validation) 


Browse 


The browse function 1s devoted to the users having no experience with the databases and a 
very little experience with the Internet. It is easy to find a given record with the use of this 
function, because it shows a portion of the database sorted by given criteria. One can 


1 : : 
Windows version only 
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select the point from which browsing should start. In the BROWSE screen the following 
options are available: 


e Selection of the sorting criterion 
e Paging button 
e Providing "Start from" value 


Search 


The search function is devoted to the users having a basic experience with the Internet and 
databases. Below we will sketch basic features of the search system. 


e A multi-criteria search has been implemented. It means that the user views а 
number of fields. Within each field one can use standard ISIS operators. The fields 
can be interconnected with the Boolean operators (AND, OR, NOT). 


e [n order to make the search process friendly, a dictionary support 1s provided to 
each field. Hence, the end-user can always refer to the dictionary of the fields. The 
dictionaries may be provided in a form of combo-box or dynamically from the 
inverted file. In this case a page with term for selection is displayed. 


e All selected terms are automatically collected in the query form field. 


e By means of ISIS Query Language function advanced users can view the 
automatically created query in ISIS Query Language and additionally edit it. 


e Опе query can be run cross a number of logically compatible databases and for the 
user all the databases can be seen as logically one database, from the point of view 
of indexes browsing, sorting and displaying the results. One can also provide 
check-boxes to enable users to mark, which separate databases should be seen as 
logically one database. 


e Тһе History function allows one to refer to the queries performed during the 
Session, so one can process the queries like, for example (#1*#2) ^ #3 


e For the answer presentation the user can select display and sorting formats. 


e The sorted output is presented on consecutive pages. 


The search interface is fully customizable: 


1. one can provide a number of independent interfaces in various languages and various 
levels of difficulty; 


2. display and sort formats can be defined by the designer; 
3. the searching screens are controlled by search definition tables (one per language). 


4. all necessary search definitions can be done easily without deep knowledge of HTML 


Thesaurus supported search 


This function can be useful for experienced users, as it provides information on logic of 
the classification of the documents. One can navigate through a thesaurus and view the 
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connections between various terms, and use them appropriately. The system is automated, 
so during the navigation process one can indicate specific words as those relevant to our 
interest. All the marked descriptors are collected into a descriptor field and the end-user 
can re-edit his/her query, add other criteria, and submit the query. As experienced, this 
type of searching provides very high precision and relevance. The main features of the 
system are as follows: 


various navigation strategy can be implemented very easily (alphabetic, KWOC, 
systematic); 


unlimited number of thesauri can be run by the system and unlimited number of 
databases and record types can be searched with the thesauri; 


If a thesaurus has links to another thesaurus or concordance table, one can easily 
implement one-thesaurus standard to the databases applying various thesauri. 


One can also use multilingual thesauri to make search in a language different to the 
language used for indexing a given database. It means that one can perform search in a 
database indexed with English descriptors, using for example French variants of the 
descriptors. 


Data entry 


The system provides a possibility to 1mplement a full-fledged data entry functionality. 
The data entry process can use ISIS formats for various checking: 


global validation and field validation; 

delete validation; 

automatic selection of the worksheet when selecting a record for update; 

ownership validation, optionally checking the record ownership before running update 
and/or delete record; 

copy the default values; 

copy the linked record values to the current record. 


The system has the following features: 


Password protected access to the modification functions 


A number of predefined worksheets can be defined for each entity class; the 
worksheets can be single-page or multi-page. 


Dynamically created lookup tables from ISIS authority databases can be available for 
selected fields. The authority tables may be picked up from the main database or 
another "authority" database, e.g. thesaurus, "corporate author name" database, 
"publisher" database, etc. It is possible to mark necessary values and pick them up to 
the field. The length of data elements in the lookup table 15 unlimited; 


static combo boxes, check-boxes, radio-buttons for selecting a value from a small set 
of data values a data entry element can be assigned to a subfield. 
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e Repeatable groups for repeatable ISIS fields with subfields can be defined on the 
worksheets. The system automatically constructs one field occurrence from each 
repeatable group (providing all necessary subfield codes); 


e the worksheets are definable by a script in a simple way. 


1.3. Platform support 


The interface has been implemented as a CG/ program [2] to be started by the HTTP 
server process. It can be run on MS platforms, and on Linux. The ISIS database can be 
stored on SQLite or POSTGESQL. The client side of the interface can be run on any 
nowadays browser. 


MS platform 


For the Microsoft family operating systems the system works on the server Windows XP 
and higher. 


UNIX platform 
This software should run on any Linux 
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2. The Interaction Scheme 


2.1. How does it work 


The flow of interaction during query formulation and result retrieval between client 
(WWW browser) and server is the following: 


л A W N 


d 
б. 


. The client activates a special process as а CGI program, which reads a predefined 


definition file, generates a query form and downloads it to the client; 


. The user fills relevant fields 1n the retrieved form; 
. The user submits the filled-in form to the server; 
. The WWW server restarts the CGI program; 


. The CGI program generates a request to the ISIS database. The request is expressed in 


the form understood by ISIS-DLL - it may be an ISIS query, request for a portion of 
inverted file, request for creating a record, etc. 4. 


. For the request expressed to ISIS-DLL by the CGI program an output is generated 


(HTML form, or list of keywords, or a message from database update); 
The CGI program passes the output to the WWW server for further interpretation. 
The WWW server returns an HTML output to the client's browser. 


Schematically it is sketched in the figure below: 


| Ium 


Server - WNT environ ment 
Internet 


Definition 





Hana 
database 





The cgi program is responsible for generating an HTML from for query formulation, 
building a query, post formatting the result, form handling, etc.". It uses a number of the 
files, which provide all necessary information during the system work. 


^ [n the case of the Linux version the request is directed to the ISIS program 
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Let us briefly explain which files are used by the system: 


1. СЕС file - it 1s a configuration file. It defines all the necessary parameters, paths, 
options, etc.; 


2. Files of ISIS database (FST, ЕРТ, print formats); their meaning is the same as in 
standard ISIS application; 


3. Database definition files - for particular functions they provide definitions necessary 
for each "ISIS record type". Hence Search Definition File specifies the searchable data 
elements (Section 4. Browse Definition file specifies the way particular record are to 
be browsed (Section 4), Entry Definition File defines worksheets for entering new and 
modifying old records (Section 4. 2). 


4. HTP files - they create repositories of the HTML patterns which are needed by the 
CGI program, whenever an HTML output is to be generated, e.g. there is a search.htp 
used for generating the search form, result.htp, which is used to generate the search 
result form, etc. More specifically the HTP files are described in Section 4. 2 


The CGI program has to be informed where is what: where are the ISIS databases, 
definitions for search screens, specifications of worksheets, etc. As mentioned above this 
"knowledge" is taken from the configuration file (3WISIS.EXE.CFG). We specify all the 
parameters of the file in Section 3. 


2.2. How data are stored 1n ISIS 


Before going into more details let us consider how the ISIS database should be arranged 
in order to make the search process efficient and friendly. Usually in one ISIS database 
one can store various types of records. For example in a bibliographic database one can 
store papers from journals (analytical level), books (monographic level), and journals 
(serial level). The records can be distinguishable in various ways, for example by a 
specially selected field that keeps type of record. The differentiation of records and their 
structure should be reflected in the inverted file. Usually when we design an ISIS 
database, we plan some data elements to be searchable. For example for a record type 
paper we chose as searchable the data elements paper's author, title, journal title, 
possibly date, descriptors, keywords from abstract etc. Obviously for the long fields, like 
for example title, we would rather think of keywords from title. For each searchable data 
element we should assign an index (Lucene index) which should be used when querying 


` [n addition in the Linux version it is responsible for the dynamic setup of the ISIS environment, it 
generates the file SYSPAR.PAR, and the communication files query, result, back.err, isis.err. The file 
query passes the request to ISIS. The file back.err logs all the requests to ISIS and stores the ISIS reactions. 
АП unusual ISIS reactions are stored in isis.err. 
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by given attribute. So, if for the author field we have the index A, we can use it in a 
6 
query : 


А: Bohr 


By using specific indexes we make our query language much more selective. If for 
example we would like to ask for all biographies on Niels Bohr we would put another 


query: 
D:Bohr 


So, as we can see, another query can be constructed for specifying the authorship, another 
one for the biography. 


In many cases it 1s also useful to add to the query language a possibility to extract only a 
given type in the search result. For this purpose we can use the distinctive field reflected 
in the inverted file by the index T. So if for example in a bibliographic database the field 
V] contains information on the document type, say 


ANA - for analytical records 
MON - for monographic records 
SER - for serial records 


we can have in the FST the line 
T dj: MET 


If we have this line, we can narrow our queries by adding T:ANA, whenever referring to 
the record type analytical: 


A:Bohr AND T:ANA 


And this 1s actually the query constructed by the system, if 1n the query form the field 
Author is filled with the value Bohr. 


? Of course there is also another way in ISIS to express that the data element should be from a given field - 
we can also ask bohr/(20). But using the tags in the process of browsing large inverted files makes this 
process very slow. 


10 
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Let us explain it in more detail. As mentioned above the CGI program uses a definition 
table. The table describes an ISIS database in that way that for each record type there is a 
section describing this type from the point of view of the search interface. The type 
description consists of (among other): 


e mnemonic name of the record type (tname) 


e for each searchable field a Lucene index is provided 


Having a query form and the database definition table the system analyses each data field. 
Each data element found in the query form in a given field 1s preceded by the index name 
specific for this field. In addition the whole query is closed into parentheses and ANDed 
by the subquery T:tname. This means that the inverted file and the search definition table 
should be properly synchronized. 


Indexes should be also designed for the function *Browse". For each data type one should 
foresee a set of attributes, which might be useful for browsing. For example, in the case of 
bibliographic database we can presume that analytical records (papers) can be browsed in 
two ways: 


e by author’s name 
e by paper’s title 


For the journal record we can presume that browsing by journal title and or title’s 
acronym may be useful. Another useful browse could be by the ISSN number. 


11 
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3. Program Configuration file - (cfg) 


The CGI program is controlled by a special Config file, which stores all the necessary 
parameters. The Config file is stored in the . ../cgi-bin directory asa *.cfg file. 
As mentioned earlier, if the name of the CGI program is name, the configuration file 1s 
also named name.cgi. The file 1s read in, and interpreted on each run of the CGI program, 
hence changes to the file take effect immediately. The * .cfg file is in the text format, 
with the lines of the form: 


parameter name «SPACBÍ(S)-or TAB(S)-^ value 


АП the legal parameters are given in the table below in alphabetical order: 


Table 3.1 


NN 
= 


БШ When set to 1 an AND/OR 
(0,13 listbox will be displayed at each 
, query field. If not applied the 
data elements in the field are 

ORed by default 


BrowseDefinitionFile text ../database.def.lang |The pathname of the browse 
definition file. 

BrowsePaging Integer 1 When set to 1, the search results 
will be subject to paging. The 
size of one page is defined by the 
parameter PagingMaxRows. 

CookieDomain text Faocd.fao.org Domain name passed with 
cookies. Cookies are used to 
cumulate thesaurus words. 

CookiePath text /cgi-bin Path passed with cookies, this 
should be the path to the project's 
html files 

DB name text PROJECT,CDS, etc. | ISIS database name. Will be used 
as default, if not explicitly 
provided in the cgi script 

DBNFile text DBN.DEF File name where the paths to the 
ISIS databases are stored. 

DebugLevel Integer The level of debugging output. 
The higher the level, the more 

0..20000 | E. ; 
detailed debugging information 
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is printed. Normally it should be 
set to 0 (see ...). 


DebugLogFile Text 


DebugProfileFile 


c:\waicent\dlog.txt | The file where the diagnostic log 
is written in the case when the 


debug level is not О 





text c:\waicent!\log.txt The file where a brief log is 
dumped. The log contains only 
the execution time for the query 
processing, so that one can 
optimize and tune the system 
environment. If present, the 
parameter works even for 
DebugLevel > 0. 


EB ur 


Deafault format text The format is used if the cgi 
program cannot identify which 
format should be used (in the 
case of History). If the format is 
to be applied, the first letter of 
the language parameter replaces 
the question mark in the name. 









Entry AccessFile text ..../access.def The path name and file name of 
the authorization data base for 
database update operations 


EntryDefinitionFile 


.../database.def.lang |The pathname of the data entry 
definition file. 


text 





When set to 1 à AND/OR/NOT 
radio buttons will be displayed 
between fields. Otherwise, the 
end-user can not specify which 
Boolean function should be 
applied between the fields. The 
system assumes AND for this 
case 


FieldAndOr Integer 
{0,1} 


| 


HighlightSearch Terms 


1 or O When set to 1, the search screens 
show the combo box for the 


selection of a display format. 


This parameter instructs the cgi 
program, if the search ouput 
should show highlighted terms 
with the reference to the query. 


Integer 


(0,1 





Text .../htp The pathname of the top-level 
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HTP (HTML templates) file 
directory. The pathname can be 
absolute or relative to cgi-bin. 


IncludeFilesPath 


Text ../htp/eng The pathname of the include files 


(Linux) 


(java scripts). The pathname can 
be absolute or relative to cgi-bin. 


c:\web\faobib\htp\eng 
(WNT) 





IsisDocLocation file://D:/faosrc/ The parameter is used for saving 


temporary in the displayed 
record in the field V9982 in 


order to show where a repository 
of the documents starts. V9982 
can be used in the display format 
to build the link to the document 
attached to the displayed ISIS 
record (useful for the CD 
applications). 





IsisDocLocationOcc One can indicate how many 
occurrences of V9982 should be 
created (should be more than 
expected number of occurrences 
of the field indicating the linked 


source document names) 


Integer 





If set to 1, the system will restrict 
the query by using the ISIS type 
from database.def 


IsisForceType 


ISIS WorkDir 


Integer 


ГЕ 


Техі /tmp/faolex The default start directory, where 


a temporary directory is created. 
(Linux) рош: М 


LINUX: the directory is used for 

storing temporary queries, 
c:\temp results, and log files each time 
(WNT) when a request to isis is directed. 


Windows NT: the directory is 


used for storing temporary files 
created by ISIS-DLL. Usually it 
is the system temporary file 


OrdersMailSpool text C:\waicent1\spool Should indicate a directory 
where the e-mail can be located 


in case when WWW-ISIS cannot 
connect to the e-mail server. 
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PagingMaxRows 


QueryMaxRows 





RestrictedTermMin 
Length 


SearchDefinitionFile 


SearchPaging 


TermSeparator 
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Integer 


Integer 


NO 


integer 


integer 


text 


Integer 


(0,15 


Integer 


(9,1) 


Text 


— 
© 


200 


E 


.../database.def./ang 


Indicates how many page links 
are displayed. If for example set 


to 10 it shows only the links 1 to 
10 or 11 to 20, 21 to 30 etc. 





Indicates how many records per 
page are displayed. 


Default maximum number of 
answered records that can be 
returned from the query. As in 
case of the Windows version 
paging is available, one can set it 
to a value between 200 - 1000, 
depending on the power of the 
server 





Minimal length of truncated 
search terms; only the fields 
specified in the query definition 
on the restricted terms list are 
tested (see page Blad! Nie 
zdefiniowano zakładki.) 


The pathname of the query 
definition file. The pathname can 
be absolute or relative to cgi-bin. 
The current value of the lang 
variable is automatically 
appended to the filename. 


When set to 1, the search results 
will be subject to paging. The 
size of one page is defined by the 
parameter PagingMaxRows. 


When set to 1, the results will be 
subject to sort. On the search 
screen a combo box appears 
when the user can select the way 


of sorting. 


Character separating terms inside 
the input field, this character will 
be internally interpreted as AND 
or OR depending on the state of 
the AND/OR selection. Standard 
ISIS operators "+" and "*" can 
always be used inside the input 
field. 


Note: do not use blank as the 
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IsisExportMimeType Text ISIS/ISO It describes the MIME type in 
case of downloading data. 


IsisSessions Integer 1 If data entry is used the value 
(0,1) should be set to 1 
IsisSessionDa text work This is the logical name that 
tabase should be defined by the dbn.def 
file 


The example below shows the cfg file for the Windows application: 





# ISIS FaoCD config file 

DebugLevel 0 

DB name faobib 

RestrictedTermMinLength 2 

CookieDomain faocd.fao.org 

CookiePath /cgi-bin/ 

HtpFilesPath c:\waicent1\Web\faobib\htp 
IncludeFilesPath :\waicent1\Web\faobib\htp\eng 
SearchDefinitionFile :\waicent1\Web\faobib\database.def 
EntryDefinitionFile :\waicent1\Web\faobib\entry.def 
BrowseDefinitionFile :\waicent1\Web\faobib\browse.def 
HighlightSearchTerms 
LatinConvTerms 
DefaultFormat @ELMON 

DebugLogFile c:\waicentl\testl.txt 
SearchPaging 1 

BrowsePaging 1 

QueryMaxRows 600 

PagingMaxRows 30 

PagingMaxPages 10 

IsisWorkDir с: \іетр 

IsisForceType 0 

IsisDataDir D: \faocd\facbib 
IsisDocLocation file://D:/faosrc/ 








Paaan 


| 


IconsDirectory /imgs 
DisplaylIcons 0 

AndOr 1 
FieldAndOr 1 
Sort 1 
Format 1 
TermSeparator Н 
ListCheckBox 1 


IsisSessions 1 
IsisSessionsDatabase work 





Note: In the Windows environment the CGI program has the extension *.exe, so its 
name is, say www-isis.exe. To this end some WWW servers require that the 
parameter file be called www-isis.exe.cfg. This 15 in particular the case of the 
Microsoft server IIS. As the Netscape server allows calling the programs by the first 
part of the name (ie. www-isis), the parameter file should be called 
WWw-lsSc-sS.Ccfg. 
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One of the main configuration files indicated by the config file is the file indicating 
location of the databases (DBN.DEF) 


Its structure is one of the following: 

1. «logical name of remote DB»; < path»; [«real name>]; sqlite 

2. «logical name of remote DB»; «URL of DB»; 1 

3. «logical name of remote DB»; [ «real name>]; pgsql; «server URL»; «port»; «user»; «password» 
The form (1) is used for a local database stored in sqlite. Examples are: 


faolex; c:\web-pages\faolex\DB\faolex.db; sqlite; 
valid; c:\web-pages\faolex\DB\valid.db; sqlite 
work; c:\web-pages\faolex\DB\work.db; sqlite 


If remote flag (=1) 1s present (form 2) the system by default presumes that the database 1s 
remote, and for this case URL should be provided: 


Legal; http://iucn.cus.de/cgi-bin/isis3w.exe ; 1; 
In this case the remote database can be used in the link ISISREF (see p. 94) 


The form (3) 1s used for the database stored in the PostgreSQL platform. An example 15 as 
follows: 


Faolex; faolex; pgsql; localhost; 5432; postgres; alphaisis 


where 5432 is the port of the postgres server (located at localhost), accessed by the user 
postgres with the password alphaisis (the name and password have to be defined on the 
postgres server while defining the storage for the ISIS database). 


Note: 


It 1s indispensable to indicate in DBN.def the work database (the logical name should be 
as indicated in the config parameter IsisSessionDatabase 


work; c:\web-pages\faolex\DB\work.db; sqlite 
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4. Database definition tables for search and browse 


Тһе new system is able to read the older specifications of database.def./ang, and 
browse.def./ang under condition that the option of cross-database search is not used. 
Therefore in this chapter we will describe the old structure of the tables and the new one. 
If one uses the new software and would like to use all its features, 1t is recommended that 
after reading 4.1 she/he refers directly to p. 4.3 (skipping 4.2). 


Note: With the new software the HTP has to be upgraded essentially. The details of the 
new requirements for HTP are in Section 6. 


4.1. Search screen definition 


The search definition table (usually database.def./ang) consists of an unlimited number of 
tables, each defining one search screen. Each particular table consists of definitions of 
table parameters, isis search database specifications, sorting formats, display formats, 
simple fields, and-or groups, and compound fields. Schematically the database 
definition table has the following form: 


X1sis table» 
(table parameters] 
«isis search database? { database; parameters} «/1sis search, database»? 


«isis search database? {database parameters} «/1sis search, database»? 


<1sis_sort> name=mnemonic namel; value= .... «/isis sort» 


«isis sort? name=mnemonic name2; value= (9fmt name2 </isis_sort> 


X1sis format» 

name = mnemonic-f-namel; value = © dformatl; 
«hsis format? 
X1sis format» 

name = mnemonic-f-name2; value = @dformat2; 


«hsis format? 


X1sis term? 


{ attribute’s parameters] | 
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X1sis term? 
X1sis term? 
lattribute's parameters2 } 


X1sis term? 


[optional and-or definition] 


«hsis. table» 


<isis_table> 


</isis_table> 


<isis_restricted_terms> term=name </isis_restricted_terms> 


Now we describe particular parameters in more detail. 


Table parameters 


name =table_name; 
table_name is the name of the search screen, to be used in all cgi links referring to 
the given table (see p. 4.2.1.1); 


isis name-ttype 
ttype it is the name that can be used for restricting query to a given type 


(T=ttype) AND (<rest>) in the case ISISType Force parameter is set in the cfg 
file; 

description=title — this parameter can be used for displaying the title of search 
screen; 

[database selection = (external|internal | 

the parameter is optional, it should be used if the multi-database search is foreseen 
for the table. In this case it indicates if the selection of databases for multi- 
database search should be provided on the search screen directly, or it should be a 
separate screen (the separate screen 1s usually useful if too many databases should 
be shown for the selection). 
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Data base parameters 


In this section one should specify all the databases that can/should be taken into account 
while performing search specified on the search screen defined by the given table. The 
specification has the following structure: 


X1s1s search database» 
isis name = dbname; 
caption = database. title to be shown on screen; 
selection = {O|1}; 
default = (0|1); 


«hsis search database» 


where 


e the value of isis name should be as defined in the file dbn.def, so that the system 
can find the path of the ISIS database. АП the formats and FSTs should be stored 
in the database (see [1]); 


e the value of caption is the text displayed on the search screen at the check box; 


e the value of selection should be set to 1 if we want to show the checkbox on the 
screen and give the user possibility to select/unselect the database for searching; it 
should be set to 0, if we don’t provide the user any possibility to select the 
database (can be used if we want to make multidatabase search transparent to the 
user); 


e the value of default defines if the selection box should be checked (1) or not (О). 
Obviously, if the selection parameter is set to 0 (no checkbox is provided), the 
value of default should be set to | (the database will be used for searching). 


Note: the specification of the selection boxes will be provided on the search screen only if 
the value of the parameter database selection 1s set to internal. Otherwise the selection 
should be made on a separate predefined screen. The screen can be also generated by the 
link: 


/cgi-bin/isis3w.exe?search type-db select show&lang2xxx&table- yyyy 


An example of such a page is provided below: 


(All necessary search java scripts should be included } 
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«FORM METHOD=POST ACTION="/cgi-bin/isisSw.exe" _ ENCTYPE-"application/x-www/form- 
urlencoded" МАМЕ="ѕеагсһ form" — onSubmit-"return submit form(this);"» 


<INPUT TYPE="HIDDEN" NAME="table" VALUE="liba"> 

<INPUT TYPE="HIDDEN" NAME="lang" VALUE="eng"> 

<INPUT TYPE="HIDDEN" NAME="page_header" VALUE="EPHMON"> 
<INPUT TYPE="HIDDEN" NAME="sformat" VALUE=""> 

<INPUT TYPE="HIDDEN" NAME-"Iformat" VALUE=""> 

<INPUT TYPE="HIDDEN" NAME="sformat_ rtf" VALUE=""> 

<INPUT TYPE="HIDDEN" NAME-"Iformat rtf" VALUE=""> 

<INPUT TYPE="HIDDEN" NAME="search_type" VALUE="db_select_save"> 
<INPUT TYPE="HIDDEN" NAME="bookmark_create" VALUE="0"> 

<INPUT TYPE="HIDDEN" NAME="SEARCH" VALUE=""> 


<TABLE><TR><TD COLSPAN=3>Database selection for searching in <B>Library Online Catalogues 


<BR><BR><BR> </B></TD> 


<I R></TR> 
<TR> 


<TD>Search In:</TD> 
<TD COLSPAN=2> 


<B>Library database</B><INPUT TYPE="CHECKBOX" NAME-"db select database" VALUE="libcat" 
CHECKED OnClick="cb_click(this)"> &nbsp; 


<B>IFAD database</B><INPUT TYPE="CHECKBOX" NAME-"db select database" VALUE-"ifbibl" 
OnClick="cb_click(this)"> &nbsp; 


</TD> 
</TR> 


<TR><TD COLSPAN=3 ALIGN=CENTER><BR><SMALL><INPUT NAME="SAVE" TYPE="SUBMIT" 
VALUE="SAVE" TITLE="Save database selection"></TD></TR></TABLE> 


</BODY> 





Sort parameters 


By choosing an element from the sort combo-box the end-user causes passing to ISIS the 
parameter on how the result should be sorted. It 15 possible to (1) provide PFT selecting a 
key for sorting (by CGI), or (2) a Lucene Index used for sorting the search results. 


In the case (1) an appropriate format generating the sort key. The sort key is assigned to 
each result record. The Web browser uses the sort key only internally, before splitting the 
answer between pages, and then displays the requested page. With the new system this 
way of sorting is recommended only for multidatabase search. Otherwise (single 
databased search) the Lucene sort function is recommended (it is faster). 
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Sort PFT 
The sort specification in the new CGI can have the form as in the old WWW-ISIS: 


<1S1S_sort> 
name=Chronologically; 
value=@CALL; 
</1515 sort? 


In this case name indicates the name as shown on the screen, whereas value shows the 
ISIS format which is used to build sorting keys. 


Note 1: The first sort line 1s the default selection. If the list provides only one choice-sort- 
element, no combo-box will be displayed on the query form, though the answer will be 
sorted by the indicated format - an HTML HIDDEN variable will be generated. 


Note 3: It is up to the designer to ensure that the lengths of particular parts of the sort keys 
are fixed. 


Note 4: The system does not support multiple selection of the sorting key. 


Below are examples of simple sorting keys. 


Example 1 


Let us assume that in an ISIS database V100 15 a field of “project title" and V20 15 the 
field of country name. If one wants to provide output sorted by the project title the format 
generating an appropriate key is 


V100 


Example 2 


If one wants to provide the output sorted by country (first sort key) and then by project 
title, the format generating the sort key should be as below: 


V20.40, C41, V100 


From the first field no more than 40 characters are taken to the key, then at the position 41 
the field V100 starts. 


For more information how to build the sorting formats, read p. 4.2.1.2. 


LUCENE sort 


The way with Lucene sort can be used if the value parameter has the form: 
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value=index:value; 
Example 


value=index: DATE; 


In this case the system will use the Lucene index DATE (as defined in the FST) for 
sorting the answer output. For more information how to build the lucene index see [1]. 


Display formats 


The meaning of the parameters name and value is obvious. Please note that the value of 
the format starts with the @ sign. 


Isis Terms 


caption — for a standard search attribute (single field) this parameter is displayed while 
creating the search screen; 


name — this is the name used by the WWW-ISIS program to distinguish searching 
elements. Within the search table it should be unique 


type — the parameter defines a type of the searching element. The possible types are the 
same as the 4^ positional parameter in the old system (see also Table 1 below). 


key — this parameter specifies the lucene index name in the inverted file for the all the 
types except 9. In the case of type = 9 for the range search the parameter should indicate 
the selected data element for which the "range" is tested, e.g. key = V90.4 means that for 
the range restriction the first four characters of V90 will be used for comparison; 


size — if the parameter 1s used for types 5 and 6 to indicate the number of values shown in 
the combobox; if used for type=// or /2, it indicates number of columns for checkboxes 
or radio-buttons respectively; 


init_value_pos — the parameter defines the position of the starting value in the combobox 
(types 5 and 6); Additionally for type=/3 it defines the selected position in the field 
combo-box; 


value — the parameter 1s repeatable and for the type = 5 and 6 it defines values for the 
combobox; For types 11 and 12 it defines codes and values for checkboxes (radiobuttons); 
for type = 13 1t defines the search attributes to appear in the compound search element (in 
the attributes combobox); 


init value — the parameter defines the starting value to be checked for types 11 and 12); 


visible — the parameter specifies if the search attribute should be displayed on the search 
screen, or is defined only for using in compound search element. The value can be only 0 
or | (not visible/visible respectively) 


Additionally in the new CGI the following parameters can be applied: 
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browse db — one can refer to an external database, e.g. validation database, thesaurus, 
author's database, etc. 


browse key — this parameter provides the brose key to the external database; 


browse. pft — this parameter provides a format for displaying the selection value from the 
external database 


Note: the browse key should indicate index with single postings (each value in the 
external database should be unique) 


If the parameters are provided the system works as follows: 


1. Lookup table is presented based on the browse key in the browse db and with 
displaying the records by the format browse. pft 


2. For the displayed terms, the system checks the number of answers in the original 
database (and displays it in the lookup table) 


3. The selected terms are used for building the final query with the use of the index 
indicated by the parameter key 


Table 1 


normal input field with no on-line keyword list (the "List" button will not 
be displayed for this field) 


normal input field supported by the dictionary list 


3 a static text field; can be used as a subtitle for a group of searcheable 
fields 


a static option list with single choice (the list of values is provided with 
the field as a combo-box) 


a static option list with multi-choice (the list of values 1s provided with 
the field as a combo-box) 


an element for “range searching" ( From" апа “То”) and text retrieval 


a check-box selection 


Compound field (with a combobox selection for the search attribute 





Below are some examples of searching elements definitions. 


Example 1 


SU e terms 


caption = Full text; name = mavail; key = 50:; type = 5; size = 1; init value pos = 0; 
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value = ; value = Available; visible = 1; 


«/isis term» 


This definition provides a combo box on the search screen with two value options — (1) 
empty string and (2) “available”. 


Example 2 
«1s1s termo 
caption = Publication Year <BR><SMALL>in the format <i>yyyy</i>; 
name = range date; 
type = 9; 
text range size=4;text range type=int; key-v64.4; 
text range from-Not earlier than; text range to- Not later than; 


«1818 term> 


This definition provides a form for range search as on the figure below. 


Publication Year | | | 
in the format yyyy, e.g. 2003 Not earlier than Not later than 


Fig. la Range search element 


For the free text retrieval (also type=9) the specification would be: 


<isis terme 


caption = Free text search; 
name = text; 
type = 9; 


text range Суре=їехї; 
text range size-45; 


«/isis term» 


Example 3 


This example shows how to define a check-box search element: 
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«1581s term» 


caption e Collection:; Name = rtype; key = T=; type = 11; size = 5; init value=; 

value =MON; value= Books ; value = ANA; value = Papers; value = SER; value = 
Serials; 

value = MIS; value = Miscelaneous; 


visible=1 


«/isis term» 


The specification generates search element as on Fig. 2. 


Collection: " Books ' Papers! Serials ' Miscelaneous 


Fig. 2 Check box search element 


Example 5 


«1518 term> 
caption=Country/Territory; 
name=Country,; 
browse key-CC:; 
browse db=valid; 
browse PFT=@v94; 
key=EC: ; 
typeel; 

«/isis term» 


In this case the lookup table is made of the records from the database valid, formatted by 
(? vO4, and displayed in the order as browsed in the lucene index CC. The search will be 
performed in the original database, with the use of the index EC 


Example 5 


In the case one would like to present the search screen with multi-attribute search 
elements, it is necessary to define a number of search elements of the type =1, assign to 
them the attribute visible=0, and then define the multi-attribute search elements 
(type- 13). The example shows such a definition. 


$1815 term» 


caption = Search in whole record (words); name = keywords record; key = K=; type = 
l;visible-0; 


«/isis term» 
«isis term» 


caption = Keywords from title; name = title; key = TK=; type = 1;visible=0; 


«/isis term» 
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sisig ретше» 
caption = Keywords from serial title; name = stitle; key = SK=; type = 1;visible-0; 


«/isis term» 


lisis Lerm> 
caption = Keywords from conference; name = conf; key = CO=; type = 1;visible=0; 


«/isis term» 


SISLS- Term 
caption = Personal Author; name = pauthor; key = A=; type = 1;visible-0; 


«/isis term» 


sisis perm 
caption = Corporate Author; name = Cauthor; key = C=; type = 1;visible-0; 


«/isis term» 
sisis perm 
caption = Thesaurus descriptors; name = dscr; key = D=; type = 1;visible=0; 


«/isis term» 


Zisis Lerm- 


caption = Language; name = dlang; key L=; type = 1;visible=0; 


«/isis term» 


sisis term- 


capbion---oonpundlr.name- --multi tern testi; type = L3; 

value = Keywords record; 

value = title; value = stitle; value = conf; 

value = pauthor; value = cauthor; value = dscr;value = dlang; 


«/isis term» 


xisis Lerm> 


caption = compund2; name = multi term test2; type = 13; 

value = keywords record; 

value = title; value = stitle; value = conf; 

value = pauthor; value = cauthor; value = dscr;value = dlang; 


</isis_term> 


gisis erm 
caption = compund3; name = multi term test3; type = 13; 
value = keywords record; 


value = title; value = stitle; value = conf; 
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value = pauthor; value = cauthor; value = dscr;value = dlang; 


«/isis term» 


«1815 term» 


caption = compund4; name = multi term test4; type = 13; 

value = keywords record; 

value = title; value = stitle; value = conf; 

value = pauthor; value = cauthor; value = dscr;value = dlang; 


</ але Сеш» 


The screen generated by this specification 15 shown on Fig. 3 





























‘Search in whole record (words) v | | [OR м [List] 
(9 AND О OR O NOT 

‘Search in whole record (words) v | | || OR v | 
© AND © OR О NOT 

Search in whole record (words) v | | Пов iw [List] 
© AND © OR О NOT 

‘Search in whole record (words) v | | OR м 








Fig. 3 Compound search elements 


Table 1 


Meaning of the Type of the search element 


normal input field with no on-line keyword list (the "List" button will not be 
displayed for this field) 


normal input field supported by the dictionary list 
a static text field; can be used as a subtitle for a group of searcheable fields 


a Static option list with single choice (the list of values is provided with the 
field as a combo-box) 


a static option list with multi-choice (the list of values is provided with the 
field as a combo-box) 


an element for “range searching” (“Егот” and “То”) and text retrieval 
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a check-box selection 





Multi-attribute search element 


And-Or groups 


This feature can be used if the search elements are grouped for being closed in 
parentheses. A general schema for defining a group 1s as follows 


<лётё Group> 
term-isisterm;; ..term-isistermmg 


SU SIS UEOUD 


By grouping the search elements we avoid erroneous construction of queries. In particular 
if OR is used between some search elements it works only within the group. Usually one 
should group formal elements restricting a query, such as document language, record 
type, date of publication. Another separate group should be defined by subject oriented 
attributes. 


29 


WWWIISIS - Technical Reference Manual 


4.2. Browse definition table 


With the new version, also the browse definition table can be defined with the XML-like 
language. 


Remote lookup 


The syntax of defining a remote lookup in entry.def remains unchanged. It is now possible 
to indicate the remote database. 


Note: in order to perform the remote access to a lookup table one has to define the table 
on the remote Browse.def (and possibly on the database.def.eng). 


The remote Browse.def can refer to an advanced format for downloading values of 
accompanying data elements from the "repeating group". So it is now possible to fill a 
field with a selected value from the lookup, but also the consecutive subfields/fields can 
be filled. The syntax of data for filling other elements should be the same as for lookup 
formats. 


Note: The referred format on the server should not contain links with local (server) URL. 


Additionally the bindings information can be provided in order to bind a thesaurus with a 
search table. 


«isis. binding? {binding parameters;] </1515 binding? 


«isis binding? [binding parameters?) </1515 binding? 


«isis. binding? [binding parameters, } </1515 binding? 
Bind definition 


As in the previous WWW:-ISIS versions, the definition of binding is used for connecting 
the thesaurus navigation with the search screen. For specifying a binding the following 
parameters should be used: 


name - binding name to which one refers while formatting the thesaurus term 
database - database name’ 
table - isis table name 


term - isis term; it indicates to which search attribute the selected descriptors should be 
assigned. 


Below is an example of a bind definition: 
<1 сир он ате абаке р 
name-bindl; 


database=libcat; 


7 Not needed, and not recommended, as the table contain it. 
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table=liba; 
term=descriptor; 


вз banding 


5. Data entry definition 


There is a simple data entry system for the Linux system. As the new Windows based 
system has been drastically developed it becomes impossible to describe both system in 
the same document. To avoid confusion we devote this chapter to the new system, which 
is now available only for Windows NT. The Linux version is described in the 
documentation [4]. 


5. ]. General information 


As in the case of search module — a special table controls the data entry screens. In this 
case it is Data Entry Definition Table. Additionally all HTML patterns are provided by 
the file ENTRY.HTP./ang. The ISIS formats play an important role in supporting the 
functions by means for providing tools for: 


- Global validation 
- Delete validation 


- Ownership validation, optionally checking the record ownership before running 
update and/or delete record; 


- Record initialization 
- Copy the default values; 


- Copy the linked record values to the current record. 


The structure of the Data Entry Definition Table is quite different from the Search 
Definition Table. Before going into details let us describe the basic idea of how the 
worksheets can be defined. An atomic data entry element on the worksheet may be: 


1. Text (one line field) 

2. Text area with a given length, scrollable (multi-line field); 

3. Single-choice combo-box (a selection list, with a possibility to select one item); 
4 


. Multi-choice combo-box (a selection list, with a possibility to select one or more 
items); 


d 


A logically connected set of check boxes; 


6. A logically connected set of radio-buttons. 
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An atomic data entry element on the screen may be assigned to: 
1. Each ISIS subfield of a given non-repeatable ISIS field; 

2. One ISIS field (may be repeatable or non-repeatable); 

3. Each ISIS subfield of a given repeatable ISIS field; 


In the case (1) we can split a subfielded ISIS field into a number of data entry elements 
assigning one subfield to one data entry element. This means that if a target ISIS field 
consists of the subfields “a and “b we can assign one data entry element to the first 
subfield, say text, and another data entry element, say a set of check boxes, to the second 
subfield. 


In the case (2) one data entry element is assigned to an ISIS field (with or without 
subfields, repeatable or not). In this case it will be our responsibility to enter to the field 
the subfield delimiters and field occurrence separators. 


The third case seams to be more difficult. We would like to have separate group of data 
entry elements for each occurrence of a subfielded repeatable ISIS field. This idea can be 
implemented by introducing a notion of "repeatable group" of data entry elements, and 
within the group one data entry element is assigned to one subfield. On the data entry 
worksheet it can be done if we have a special button, which allows us to provide such a 
group whenever a new occurrence of the subfielded field has to be added. 


The Data Entry definition table 1s prepared by means of a special script. With the script 
the particular record types are described in separate sections. Each section contains 
description of all pages belonging to the worksheet. The page section consists of 
description of the data entry elements (which may be a text area, combo box, check box 
etc), and the specifications of other screen elements, e.g. texts, images, etc. The scripting 
language is very simple. АП the constructs are described hierarchically: 


- the table consists of description of worksheets; 

- each worksheet definition consists of the definitions of pages; 

- each page describes ISIS fields. 

In addition each field may consist of a set of ISIS subfields. 

Each of the above constructs 1s described by the corresponding sections: 
- worksheet section 

- page section 

- field section 


- subfield section 


The convention for starting and ending the sections 15 similar to the XML style, so that we 
have: 
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A. Worksheet section 
«isis. worksheet? 
Worksheet definition 


</isis_ worksheet»? 


B. Page section 
«isis page»? 
Page definition 


</isis_page> 


C. ISIS field section 
«isis field» 

Field definition 
«hsis field» 


D. ISIS subfield section 

«isis subfield^? 
Subfield definition 

</isis_subfield> 


Note: The sections start and end in separate lines 


Below we describe in detail particular sections. 


5. 2. Description of the data entry sections 
Worksheet section 


In the worksheet section the following parameters are defined: 


Parameter Status Explanation 
name 


Name Obligatory The parameter provides a name of the worksheet, 
which can be used whenever calling data entry 
function. For example опе сап specify: 
name=MON 


Obligatory This parameter specifies title of the worksheet. It 
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LT can be displayed on top of the worksheet frame. 
Obligatory The parameter specifies ISIS database for which 


the data entry/update worksheet 1s being defined. 


Path optional The parameter provides the directory of where the 
database, along with formats, FST, ЕРТ, etc., is 
stored. If not provided, the system uses the path 
found in the file indicated under DBNFile in the 
config file (see page 12) 

Valid. ptf Optional The parameter provides name of the validation 
format (see Section 5. 4) 

Уй Optional The parameter provides name of the validation 
definition table (see Section 5. 4) 
Del. pft Optional The parameter provides name of the delete control 
format (see Section 5. 4) 


On. new. рўї Optional The parameter provides name of the format 
generating commands activated when the new 
record has been created (see Section 0) 

On update pft | Optional The parameter provides name of the format 
generating commands activated when the new 
record has been created (see Section 0) 

proof pft optional The parameter provides name of a format for 
proof-reading. The format is inviked after having 
saved the record (new or modified) 


Magic Strongly The parameter can be used to store the version 
recommended | number of the worksheet. If the worksheet used by 

a user has different value from that specified in the 

worksheet definition, the system rejects the 

request for entering new record or updating an old 

one. The parameter improves protection against an 

unauthorized data entry as well as simplifies 


maintenance of the data entry subsystem. 





After having provided the main worksheet parameters one has to define page sections. 


Page section 


Each page section starts with defining the parameters name and title. As the worksheet 
page cannot be displayed without the other pages belonging to the worksheet, the 
parameters have only the documentary meaning. In addition the parameter number can be 
provided. It defines the sequential number of the page. 


Example: 
Name = MainPage; 
Number = 1; 
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Title = Main bibliographic data; 


After having provided the main page parameters one has to define ISIS fields, providing 
field sections. 


ISIS field section 


ISIS field section defines one or more data entry elements assigned to an ISIS field having 
a given tag. Thus two cases may appear: 


1. The ISIS field has assigned one data entry element (this 15 recommended, if the field 
does not consist of the subfields); 


2. The ISIS field consists of a number of subfields. In this case it is recommended that 
for each subfield one data entry element is assigned 


For the both cases above each ISIS field section starts with defining the following 
parameters: 


Name - this is a mnemonic name, to be used by the cgi program in order to identify the 
given definition; 


Description - this 1s description of the field appearing on the worksheet; 
Tag - the parameter assigns an ISIS tag to the field; 
Note: The parameters above are obligatory. 


Below we describe the two cases 1n more detail. 


Case 1 - one data entry element is assigned to the ISIS field 





In this case the specification of the parameters field name, description and tag 1s followed 
by the data entry element specification. It describes, a type of the element, and its specific 
attributes, such as lookup values, default values, etc. 


Type - if the ISIS field is to be assigned to the data entry element, the parameter is 
obligatory. It describes the type of the data entry element. The following values are 


available: 


2 Text area 


3 Single-choice combo- 
box 


Multi-choice combo- 


box 


Check boxes 


БО і Radio buttons 
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Protected field (no data 
entry) 





EN File upload field 


default - the parameter provides a default value. It can be applied for any type of the data 
entry element 


Repeat - this parameter defines, if a new occurrence of the data entry element can be 
added for the new occurrence of the ISIS field. The following options are available: 


A special button "ADD NEW" will 
allow the user to add another occurrence 
of the data entry element to the page 


The button ADD NEW is not provided, 


The parameters below are specific for particular type of the data entry element. 





Text and text-area (types 1 and 2) 


Size - 1f the ISIS field is to be assigned to the data entry element, the parameter is 
obligatory. It provides the size value of text or text-area data entry element; as a value, 
one can provide one of the following: 


small, medium, large 


or an integer value №. If the type of data entry element is text, № denotes number of 
characters of the field (scrollable); if the data entry element is a text-area it denotes the 
number of columns of the text-area. For text-area additional parameter rows is needed to 
indicate the number of rows. 


Rows - see above; 
Max. size - the maximum length of the text, that can be entered to the data entry element. 


Note: the parameters size, rows, max size will be ignored if the data element types 3-6 are 
selected. 
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Figure 5.1. Example of the selection list — multi-choice type 


Examples 

1. To define a data entry element of the text type of medium size we specify: 
Type = 1; Size = medium 

2. To define a text area for 50 columns large, having 5 rows we specify: 
Dupe scs Sige жш 50) e 

3. To define a text for the year we can specify: 


Type =: lo. S176. = 47 max ‘si 76=47 


For the types | and 2 one can define an authority list, where specific data elements can be 
picked up from. The authority list is driven by the inverted file and is performed by the 
same procedure as in BROWSE. An example of such a selection list for individual author 
is shown in the figure below. 


In order to define the lookup list a number of parameters should be defined. They are 
provided in Table 5.1. 


Table 5.1 


Path The path to the database. If no database 1s provided the system 
assumes that the same database will be browsed 


bn 
Pfx Prefix indicating the name of the Lucene index in the inverted 
Fmt 


EN file to be used 


The format to be used to format the selection lines (see 
examples below) 


Startterm A term starting the displayed selection list; by default empty 
string 15 taken as a start term. 


lookup. type The parameter specifies, if there is a lookup for the field or not. 
If the value is 0 no lookup table will be provided; if its value 1s 
set to 2, the button BROWSE will accompany the field. 


Lookup choice | The parameter specifies, 1f the selection from the list 1s single- 
or multi-choice. The possible values are: 


1 - single choice 

2 - multi choice 

3 - no choice 

Note 1: If the list is defined as single-choice, it 1s 
recommended, that the choice display format displays radio 
button, if multi-choices — checkboxes, otherwise no selection 
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means can be provided; 
Note 2: No choice option can be useful for the fields which 
values should be unique, e.g. record ID, ISSN in the Serials 
database, Personal ID 1n a roster etc. 

table If we want to provide a Browse list with various browse orders, 
it is possible to refer to the Browse table from BROWSE.DEF. 
In this case the end-user can view the list in various ways as it 
is in the BROWSE function in the search subsystem. 


Dimtr. 1 If the multi-choice option has been applied for the selection list, 
it shows the left delimiter that will be added to each selected 
item on the left side when the record 1s saved. 


Dimtr. r If the multi-choice option has been applied for the selection list, 
it shows the right delimiter that will be added to each selected 
item on the right side when the record is saved. If not provided, 
by default the delimiters are empty strings. 

Example: for the descriptor field one can define left and right 
delimiters as follows: 

dimtr l=< ; dimtr r=> ; 

If selected terms are ABA and LAND they will be saved in a 
field as 

<ABA><LAND> 


Gen_occ Possible values: YES, NO. If the multi-choice option has been 
applied for the selection list, it informs the system that each 
selected item should become a new occurrence of the given 
field. 

Create This option can be used, if we allow end-user adding authority 
data in the case when the end-user cannot find the proper item. 
Possible values are YES, NO (the default value is NO) If the 
option is used, a special button CREATE NEW appears on the 
Browse list, enabling one to invoke the data entry process for 
the new record. 

Create_type This option can be used along with the create option. It 
indicates the worksheet (name) that should be provided, if the 
end-user starts adding a missing element. 


Init. pft The parameter provides a format which initializes the new child 
record started with the button CEATE NEW from the Browse 
screen (see the parameter create) 


Combo-box (types 3 and 4) 





Values - the parameter describes in the list form which values should appear in the 
combo-box and how are they coded in the record. For example, if 


values-Monograph|M,paper from book|AM, paper from journal|AS 
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the combo-box will show three values - "Monograph", "paper from book" and "paper 
from journal" whereas to the record the corresponding code (M, AM or AS respectively) 
will be entered. 


Note: If an ISIS field is defined, such that it is not obligatory, it is recommended that the 
first value on the value list 1s empty string. In this case if nothing is selected the ISIS field 
will not be created. 


Size - the parameter defines the window size for the combo-box. For functional reasons, if 
a single-choice combo-box is defined, it is recommended that the window size is set to 1, 
so that the selected value 15 visible. 


Gen occ - the parameter can be applied only for Multi-choice combo-box data entry 
elements. It has the meaning as for the selection list (see the table above). 


Radio buttons and check-boxes 
Values - as above; 


Gen, occ - the parameter can be applied only for check-box data entry elements. It has the 
same meaning as for the selection list (see the table above). 


Note: The radio button data element should be used only if single choice is available, 
whereas check-boxes should be used whenever more than one data element can be 
selected. 


Note: In case of radio button data elements, if the ISIS field (or subfield) 1s not obligatory 
one has to foresee an option "Not applicable" with empty code value (""). 


Note: In case of the check boxes one has to foresee how to represent the multi-choice. To 
this end if a set of checkboxes corresponds to a non-repeatable ISIS field, one has to 
define left and right separators, e.g. « and >. If it corresponds to a repeatable field, one 
has to add the option gen occ-yes, so that each selection would create one occurrence 
of the field. 


The fields represented on the screen in the form of radio buttons or checkboxes can be 
displayed in few columns. To define so, one can use the parameter 


cols= nn, 


where nn is a number of columns. Example of such a definition is given below: 


66 тлела? 

name = publ type; description: = Type or document (2); 

tag-3; type-6; cols=2; 

values-(B) Book/Monograph/Annual report|B, 

(C) Standard|C, (D) Drawing/Photograph|D, 

(С) Atlas/Map/Cartographic|G, 

(J) Journal artzcle|J,(P) Patent|P,(R) Report|R; 
</isis field» 


Case 2 - more than one data entry elements are assigned to the ISIS field 
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In many ISIS applications it is useful to design ISIS fields containing sub-fields. In this 
case it 15 recommended that for each sub-field one data entry element be assigned. If an 
ISIS field containing sub-fields is repeatable we can define a repeatable group for the data 
entry elements: each occurrence of the data entry elements is assigned to the ISIS field 
occurrence. Splitting the contents of one ISIS field into a number of data elements has the 
following advantages: 


- the user is freed from remembering to enter the sub-field code, as the system does it 
automatically, when combining the data entry elements into one field; 


- itis possible to define various (the best) data entry types for each sub-field, in 
addition one can provide various authority lists to various sub-fields of the same field; 


- from the point of view of a naive user it is much easier to understand the notion of 
data entry element or a group of the elements rather than think of the structure in 
terms of the ISIS fields and sub-fields. 


For example, let us assume we have to store in the ISIS bibliographic record information 
on authors, their affiliation, and the role. The author field is repeatable, therefore we have 
in the database structure a repeatable field consisting of three sub-fields: 


- authors name 
- author's affiliation 
- author's role 


For such a case it 1s reasonable to have a repeatable group of data entry elements. Within 
the group we can have one data entry element for the name ("text"), one element for the 
affiliation (could be a text area), and radio buttons for selecting a role (editor, illustrator, 
translator). Below we describe in more detail how a data entry worksheet can be defined 
for the subfielded ISIS field. 


If an ISIS field consists of sub-fields, and we want to define a repeatable group of data 
entry elements, the general structure of the definition is as follows: 


©те ектем 
name = name; description = title; tag- nnn; [repeat = yes;] 
isis subfield section; 
isis subfield section; 


isis subfield section; 
«/isis field» 


The isis subfield section has the following structure: 


«L9S15 бирле а» 

Name = name; description = title; tag = subfield tag; 
Data entry element description 

«/isis subfield> 


where 


e name - this is a mnemonic name, to be used by the cgi program in order to identify the 
given subfield definition; 


e description - this is description of the subfield appearing on the worksheet; 
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e subfield tag - the parameter assigns ап ISIS subfield code to the data entry element. Its 
value consists of the character ^ and the subfield identifier (one character); 


e Data entry element description - the description of the data entry element is the same 
as for the field. So, one has to define type of the element and according to the type all 
necessary attributes (lookup values, codes, etc.) In particular, if the data entry element 
for the subfield 1s a text or text-area, one can define a lookup table as described above 
for the field. 





5.3. Examples 


In this section we illustrate the possibilities of defining worksheets by a number of 
examples. Examples 1-4 show how we can design a field without subfields. In Examples 
2 and 3 we discuss how the formatting language should be used in order to provide 
selection lines in the lookup table. Example 5 shows the idea of repeatable group, which 
is used to define a repeatable field with subfields (each data element on the screen defines 
a subfield, all subfields are then used to build a field occurrence). 


Example 1 


Let us assume we want to define a data entry element for the abstract field (in ISIS it 1s 
repeatable field). The definition of such a field would be as follows: 


«1515 iield> 
name = abstract; title = Abstract; tag= 60; repeat = yes; 
type=2;7 s126-9l1àrge; lookup types0; 

«lasts field. 


In this specification we define a text area for the ISIS tag 60. The button ADD NEW is 
provided, which can be used to add an area for the next occurrence of the abstract field. 
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Example 2 


Let us assume we want to define a data entry element for the corporate authors field (in 
ISIS it 1s repeatable field). We would like to provide an option of selecting the data from a 
lookup table built from an authority database named A-CORP. In addition if the user does 
not find the element on the list he/she should be able to add the missing item to the 
database A-CORP. The definition of such a field would be as follows: 


сваке 
name = c-author; title = Corporate Author; tag- 31; repeat = yes; 
type-1; size-medium; lookup type-2; lookup choice=1; 
dbn-A-CORP; 
pix > CAs; It CASOEN; OfOate- yes; create: type: = CA-WEkSDCt; 
</isis ftierd> 


In this specification we define a data entry element for the ISIS tag 31. The data entry 
element is in the form of “text” line. Two buttons are provided: ADD NEW and LIST. 
The first button can be used if the user wants to add an area for the next occurrence of the 
field 31. The second button provides a select list (single choice type) where an appropriate 
value can be selected. The list 1s created in the following way: 


1. The inverted file of the database A-CORP 15 taken from the index CA; 


2. For each posting of each access point from the index CA the format CA-SEL is 
applied and the generated line is displayed (by the format CA-SEL). 
Note: It is the format responsibility to provide the selection means (a check box or a 
radio button). See for example the construction of the selection format below. 
Note: If the check-box 1s applied the system would take only the first checked 
element. 


3. The list of browsed values 1s paged according to the paging set up as defined for the 
BROWSE function (see the CFG parameters for paging). 


In addition the Browse screen will have a button CREATE NEW providing a possibility 
to create a new Corporate Author record if a needed value cannot be found in the list. 


The selection list of the corporate authors is created by the indicated format (in this case 
CA. SEL). Provided the authority record contains the corporate Author name in the field 
V120, the format may be as follows: 

'<TR><TD VALIGN=TOP><INPUT TYPE="RADIO" NAME-"de browse name" VALUE-"'v120'"»' 

кєрк 20" </TR>" i i 

Let us analyze the format in more detail. As one can see, it provides a line with a radio 
button, for which the return parameter is named de browse name, and its value 15 the 
field v120, then an explanatory text is given (in this case it is also contents of V120). 
Please note that this technique allows one to provide an explanatory text different from 
the selection value. In addition the technique allows one to display the data elements 
varying from the terms in the inverted file. 


There is also another important possibility with the "selection format" - it 15 namely 
possible to indicate under the parameter value, that we would like to "import" some fields 
from the indicated record. To import some values to other fields on the worksheet the 
format has to generate the following text: 


<INPUT TYPE="RADIO" NAME="de browse name" 
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VALUE-"selection data#t##tt ,###value for the field tt ,### tt; 
Value for the field ЁЁ, etc. 


where tt, is the tag on the worksheet where the data value for the field tt; will be 
inserted. 


Let us presume that in the worksheet we have the field "Corporate Author" followed by 
the field "Address" having assigned the tag 311. The authority records for Corporate 
Authors contain the name in the field У120 and Address in V121. If we want that with a 
selection of a value from the list not only the corporate author name is taken but also the 
address is imported to the field V311 we can "program" it with the format: 


'<TR><TD VALIGN=TOP><INPUT TYPE="RADIO" NAME-"de browse name" 
VALUE-2"',v120, '###311###',V121,'">!' 


"STD 7120 "</TR>! 
As one can see the parameter value will contain the address taken from the authority 
record from the field 121 and the value will be labeled by the tag 311, so the system will 
insert the value to the field tagged as V311. If there is already a value, it will be replaced 
by the new value. 


Import rules 
For importing fields the following rules apply 


1. One can import non-repeatable fields to non-repeatable target, e.g. downloading 
Serial title, followed by ISSN; 


2. If the target is a repeatable group one can design a format that imports data for 
each repeatable group. Within the group no field can be addressed more than once; 
if we design a format for the repeatable group, no data that is out of the group 
should be imported; 


If from the indicated record we would like to import a repeatable field, (say, a selection of 
two or three authors), on the target worksheet site we cannot apply the repeatable group; 
instead, we plan importing all the repeated data into one text/text-area field — the data 
should be separated by semicolon (;). 


Example 3 


Let us assume we want to define a data entry element for the descriptor field. We would 
like to provide an option of selecting the descriptors from the thesaurus database named 
THES. The user cannot add any term to the thesaurus database. The definition of such a 
field would be as follows: 


€1818 ryeld- 
name = descr; title = Descriptors; tag= 72; 
type-2; size-medium; lookup type-2; lookup choice=2; 
don-THES; path= c:\waicent\bases\AGROVOC; 
pfx = E:; pit= DSC-SEL; table=DSCl; 
dlmtr ll =<; Сїт. se 
</151.5 field> 


In this specification we define a non-repeatable text area for the ISIS tag 72. The button 
LIST is provided. It can be used to display a select list (multi choice type), where 
appropriate descriptors can be selected. As we refer to the BROWSE table DSCI, a 


43 


WWWIISIS - Technical Reference Manual 


combo-box on the screen provides a possibility to choose the way we want to browse the 
thesaurus: either alphabetically or as a permuted list (KW OC). 


When selected, the terms are displayed in the text area as a list, separated from each other 
by a semicolon. When saved, the terms will be closed in brackets, which are the defined 
delimiters (“<” and “>”). 


For the sake of completeness we present below possible display formats that are typical 
for selecting data from the BROWSE list. 


'<TR><TD VALIGN=TOP><INPUT TYPE="CHECKBOX" NAME="de browse name" VALUE="' 
if p(v001) then v001 else V003 fi, 
'"><Тр>!' 
if p(v001) then 
'«FONT FACE-"Arial,Helvetica" COLOR=GREEN SIZE=2><B>'v001'</B></FONT>', 
else 

'<FONT FACE-"Arial,Helvetica" COLOR=RED SIZE=2><I>'v008'</I></FONT>' 
,DUOS" use: ", 

"<FONT FACE-"Arial,Helvetica" COLOR=GREEN SIZE=2><B>'v003'</B></FONT>', 
fi, 
ra TRA 


The provided format starts every line with a check-box. Non-descriptors (field v8) are in 
red color. 
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АВПОМЕН 
Document: Done 











Figure 5.2 Selection list for the thesaurus 


In case of a multilingual thesaurus one can easily implement the list where the descriptors 
are displayed in English, but the selected values are in French, or vice versa. 


Note: If one would like to display values from the inverted file, the term value 1s stored as 
a virtual field with the tag 9980 
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Example 5 


Let us show another format displaying the thesaurus terms in a KWOC form. In this case 
we would like to show exact form, which 1s in the inverted file. To do so we use a 
temporary field V9980 which stores the term as it is found in the inverted file: 


"<TR><TD VALIGN=TOP><INPUT TYPE="CHECKBOX" NAME="de browse name" VALUE="! 

if p(v001) then v001 else V003 fi, 

rae TS 

'XFONT FACE-"Arial,Helvetica" COLOR-BRAUN SIZE=2><B>'v9980'</B></FONT>: &nbsp; ' 

if p(v001) then 

"<FONT FACE-"Arial,Helvetica" COLOR=GREEN SIZE=2><B>'v001'</B></FONT>', 

else 
'<FONT FACE="Arial,Helvetica" COLOR-RED SIZE=2><I>'v008'</I></FONT>!',DO08" use: " 
'<FONT FACE-"Arial,Helvetica" COLOR=GREEN SIZE=2><B>'v003'</B></FONT>', 

Ed 

'</TR>' 


, 


Example 6 


Let us define an Author field that consists of three subfields: 


e  Authors' name (subfield ^a) 
e Its role (subfield ^b) 
e affiliation (subfield ^c) 


The field 1s repeatable. We presume that there are two separate databases for the authority 
files of the author names and affiliations (named AUTH and AFFIL respectively). We 
would like to provide the lookup lists and if needed, provide the user possibility to create 
new author records and affiliation records in the authority database (AUTH). The 
specification below provides three separate data entry elements: 


сла: туеш» 
name = auth; description = Author; tag-28; repeat = yes; 


SISTI SUD etd: 

name = A-name; description = Author Name:; tag=^a; 

type-1; size=medium; lookup. choices; 

dbn=AUTH; path= c:\waicent\bases\AUTH; 

pta = At; pLit=-A-SEL; -Create= yes; Create type = .A-wrksHt. 
</isis süubfield> 


“1515 .subtielda> 


name = A-role; description = Its Role:; tag-^b; 
Суре зше cd. lookup Choice: = 7 
values = |,editor|ed.,illustrator|ill; 


Sane sübfield> 


леа. ште» 
name = A-Aff; description = Affiliation:; tag-^c; 
type-1; size = large; lookup choice-1; 
don-AFFIL; path= c:\waicent\bases\AFFIL; 
DEX. = APs; DIL AFP Son, Create= yes; Create type = АКЕ, 
<x/isis sübfield> 


«1815 field> 
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As one can see, for a field occurrence we have here three separate elements, each for the 
particular subfield. Each subfield data element on the screen can be equipped with a 
lookup table or a check-box, depending on the real needs. 


5.4. Validation tools 


As mentioned in Section 5. 1, the following validation structures can be defined: 
e Global validation format 


e Delete validation format 


Note: The old WWW-ISIS system had additionally a possibility to define Field 
Validation Table, which of a worksheet could define the set of values allowed for some 
fields by means of the values in the index. The new formatting language makes it possible 
to express such conditions therefore the Field Validation Table is not used anymore. 


Validation format 


Global validation format has a structure of a standard ISIS format, checking all necessary 
conditions for accepting the record. If a condition is not fulfilled the format should 
generate a message in the form either: 


<ERR> . . . message text . . . «/ERR» 
<WARN> . . . message text. . . </WARN> 


In the first case it is presumed that an error has been detected and the error message is to 
be issued, in the second case the system provides a warning. The main difference between 
the errors and warnings 1s that for a record generating an error message it 1s impossible to 
save it, whereas the end-user can save a record if only warning messages are issued. 


The error/warning messages are displayed in the area between the title of the worksheet 
and the paging bar. It is up to the format designer to decide, in which form the messages 
are to be printed (order, font, colors, etc). 


An example of the validation format is provided below: 


IF (V21:'L') апа a(v22) THEN "<ERR> <BR>For file assignment '"V21"' -", ' the field 
"Library Call No" is obligatory.</ERR>' fi/ 


IF VO6='T' апа a(v07) then '<BR><ERR>"Relator" is "T" - "REL. TRN(07)" field is needed 
</ERR>! fi/ 


IF V11<>'MS' and (p(v41) then '<BR><ERR>"SERIAL TITLE" present - "Bibl. Level" must be 
"MS" </ERR>' fi/ 


ТЕ V11='MS' апа a(v41) then '<BR><ERR>"Bibl. Level" is "MS" - Serial title is needed 
</ERR>!' fi/ 


IF a(v31) and a(v29) THEN 


"<BR><ERR>For Monographic document at least one Personal or Corporate Author is needed. 
</ERR> ' fi/ 


IF A(V34) THEN '<BR><ERR>"Monographic title" should be present «/ERR»' fi/ 


"<BR><ERR>The field 'Lang. of text' is obligatory </ERR>"N44/ 
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if p(v34^e) and (not V44: 'EN') then '<BR><ERR>English Title exists - "En" code should 
be added in "DOC.LANG"«/ERR»'  fi/, 


if v5b4-2'«(»nd«)»' then else "<BR> <ERR>Publication Year must be present<ERR>" 


N64/ fi 


Below 1s an example of the format which controls the contents at the field level: 


(if p(v17) then 

e1:-npst(;xtrim(v17); TT ), 

if p(v1) and (e1=1) then if v1-s(Iref(;xtrim(v17); TT ;v1)) then e1:=0 fi fi, 

if е1>0 then |<WARN><B>Title of Text</B>: value <FONT COLOR="red"><B>|V17|</B></font> already 
exists in the database - possibly a duplicated record (page 1)«/WARN?» | fi/ 

fi) 


This example checks for duplicate records by testing if a title value exist already in the 
index. 


Delete validation format 


Delete validation format has the structure of a standard ISIS format, checking all 
necessary conditions if the end-user issues the command DELETE RECORD. If condition 
for deleting the record is not fulfilled the format should generate a message. Below is ап 
example of delete format: 


if L("BT-"V01)»0 then, 
'«BR»Cannot delete record - some records refer to it as IMPLEMENTS '/fi, 
if L("AT-"V01)»0 then, 


'<BR> Cannot delete record - some records refer to it as AMMENDS '/fi, 


Note: Within the validation and delete formats one can use the virtual fields storing some 
system information like current date, User ID and IP. The tags of the virtual fields are the 
same as for on, new and on, update formats, 1.e.: 


9970 - IP address of the end-user 
9960 - User Identifier (as used for login) 
9950 - date in the format DD/MM/Y Y Y Y 


It is therefore possible in the validation format to control if a given user is authorized to 
update a given record. Provided that there is a field in the record which stores the record 
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"owner", the validation format can check if the current user is authorized to change the 
record 


5.5. ON NEW and ON UPDATE functions 


In many cases there is a need to perform a kind of "auto-correction" on the newly entered 
or updated record. It may mean adding (or changing) automatically to the record a special 
field at the moment the record is created (updated). Examples of such fields are User ID, 
Date of entering the record, etc. To this end special functions ON NEW and ON 
UPDATE have been implemented. The functions can be invoked by the formats 
on new pft and on update pft, which can be specified in the worksheet 
section of the definition file entry.def . The following operations can be performed with 
both functions: 


This function makes possible to add a field to the record 
REPL This function replaces a given field by the string indicated 
This function can be used to delete a field from the record 


This 1s string replace function, which works on the record dump. It 


can be used if a replacement is needed for a repeatable field. 





The syntax of the operations is as follows: 


ADD <tt> tert неў е 
BEPI. UE text «BEES 
ПЕЙ РЕВ 


SR %S%0ld уа1це%%пеу valuess 


Explanations 
1. In the case of ADD а new occurrence of the field with the tag tt will be added 


2. In the case of REPL all occurrences of the field with the tag tt will be removed and the 
new occurrence having the value text will be added. 


3. In the case of DEL all occurrences of the field with the tag tt will be deleted 


As we can see the function REPL cannot be used if we want to replace each occurrence 
of a string in the record. In particular, if a field 1s repeatable and in each occurrence of the 
field we would like to change an old value by a new one the function REPL would not 
work. To this end the string replace function has been implemented. The function works 


* With the function on new one can define fields which are automatically filled by 
"record owner" (see section. 5. 5) 
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on the record dump. In this case for a repeatable field we can generate a sequence of 
commands, each working on one occurrence. For example if the format ON NEW 
generates for a record the following sequence 


SR $9«20»antibiotio«/20»599«20»2ANTIBIOTIC«/20»2$* 
SR %%<20>peniciline</20>%%<20>PENICILINE</20>%% 
SR $$«20»5tetracycline«/20»5$$«20»TETRACYCLINE«/20»$$ 


it will cause changing of each occurrence of the field V20 to upper case (note that the 
operation will be performed on the record dump). 


If the parameter on new pft is used for the given record type the following sequence 
of operations will be performed by the system when the SAVE operation is invoked for 
the record 


(a) If no errors detected by the validation formats, the new record is saved 
(b) After having written the new record the system will: 
- read the record again; 
- set date, login, IP to the virtual fields (see the tags of virtual fields below); 


- perform the format specified as on new ptf; the format result should generate a 
set of command lines for adding/changing selected fields of the record; 


(c) With the generated sequence of commands the system will update the record; 


(d) The system will save the changed record. 


The format on new pft is invoked only when the new record is saved. If an existing 
record is being updated, the format on update pft is invoked instead, and a similar 
procedure will be performed. 


Within the on_new and on_update formats one can use virtual fields, which provide 
useful system data. Below we specify the tags for the virtual fields: 


9970 - IP address of the end-user 
9960 - User Identifier (as used for login) 
9950 - date in the format DD/MM/Y Y Y Y 


Below we illustrate how the formats on new pft and on update pft can be 
constructed. 


Examples of the format specifications 


SADD <20> "y MEN (6б), *</20 ' this will add MFN to the field v20 


"ADD. «20» МОҢ", MEN (6) «720» this will add the record ID to the 


field v20 (equal to MFN). The 
record ID consists of the string 
MON- followed by MEN 
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"КЕРІ «20» ', MPU V20,'</20>! this will change the value of the 
field V20 to upper case (provided 
that the field V20 is not repeatable) 


"БЕРЕШ TV20 ау This will add to the field V20 the 
'«/20» ' subfield ^a with the value of V21 as 


the contents of У20 


MPU, (ISR %%<20> |, V20,|</20>%%|/) | It is a repeatable group which for 
each occurrence of the field V20 
generates the SR command which 
performs the replacement of 
existing value by the same text in 
upper case. 





Using REF in the format one can take a coded field and add the extensions as occurrences 
of another tag (in the current version both the function ISISREF and REF can be used). 


If we want to store the information on who has entered the record, we can do it with the 
following format: 


This will add the User ID to the field 
v20 





ADD? <40> “Ty WO99s0 ter. This will add the current date to the 
field v40 


By adding those lines to the format on update pft, ina similar way we can cumulate 
in the record the "signatures" of the users updating the record. 


5.6. Access authorization 


The data entry system is equipped with the access control mechanisms. One can define 
privileges for particular user groups, so that a user may have enabled or disabled access to 
specific database update operations. All the privileges are specified by means of the 
access definition table stored as the file access.def in the directory as indicated in the 
configuration file (see Table 3.1 


The general idea is that in the access definition table all the users and users groups are 
defined. Each user is assigned to a user group, whereas the user group specification 
defines which operations are available. 


Below we describe in detail the structure of the access definition table (ADT). The syntax 
of ADT is similar to the syntax of the worksheets definition table, i.e. it consists of 
sections "labeled" in a way similar to HTML. The following sections can be defined: 


e Isis group section 


e ISIS group entry section 


50 


WWWIISIS - Technical Reference Manual 


e [15 user section 


Isis group section is built of a number of isis group entry sections. Each isis entry section 
defines worksheets and functions that can be performed. The syntax of the section 
isis. group and isis group entry is sketched below: 


S1s1sS group 
name-groupName; 
€rsSTSgroup entry 


worksheet=Wname,; rights-r;; r12 r3 





</isis group entry» 


леб. group entry 
worksheet=Wname; rights-^r;, r2» r53 


CATSISCQgTQUD Snr 


sisis group entry 
worksheet=Wname; rights-^r,; Fn fg 


сусе: group embry- 


СОЕ не Groups 


In this specification the following parameters are definable: 
e Name is the name of defined group 
e worksheet is the name of worksheet 


e rights isthe parameter defining the rights. Possible values of the parameter are: 
A - add new (create) 
M - modify 
D - delete 


The syntax of the section isis user is sketched below: 
теле User? 
name-user; password-password; groups = name;, пате», ... патек; 


SI IS15: 568: 


So, for each user the isis user section defines User Id, password and a list of groups 
to which the user belongs. 


There is one user name, which has a special meaning. It is namely the name PUBLIC. 
This name is reserved for those users, who can access the system functionality without 
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any password. If for example we would like to provide a functionality to log orders in an 
ISIS database, we can define the worksheet ORDER and in the authorization table we can 
define: 
€1519 Group 
name = Guests; 

xisi qroupceHtry- 

worksheet=ORDER; rights=A; 

<j ISrIS Group entry? 

аксона ора оер 


теле User 
name = public; password-; groups - guests; 
</isis user> 


With this specification any user without login can access the worksheet ORDER for 
adding new records. 


Note 1: For the worksheets which are available for public users the data entry does 
not work with the session database, so the record size is limited to 2K. 


Note 2: In the existing version the Access Definition Table has to be edited 
manually by the database administrator. The next release will provide tools for 
editing the authorization table from the web browser. 


5.7. Accessing records for update 


A basic way of accessing records for update is to use one of the functions SEARCH or 
BROWSE and display the records with buttons that refer to the update function. In the 
display format one can also provide the buttons for copying some values of the current 
record to a newly created record, DELETE button or any other necessary function that 1s 
application oriented, e.g. ORDERing, LOANing, etc. A standard screen with the 
displayed records is shown on the figure below: 
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3% FAOBIB Data Entry - Netscape 
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Update | Improving growth prospects in the Pacific (English) In: Pacific Studies Series (Philippines), / Asian Development Bank, Manila 
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377632 C 


The Borana and the 1991-1992 drought: a rangeland and livestock resource study (English) Alemayehu Mengistu / Addis Ababa 
(Ethiopia), Institute for Sustainable Development/French Catholic Committee against Hunger and for Development , 1998 , 90 p. 








View Update Copy Copy ind. Holdings 
377634 
Fertilization of rice in Japan (English) Suzuki, А. / Japan FAO Association, Tokyo (Japan) , 1997 , 111 p. 








41| 
iai == | ‘Document: Done =| x 4 gP e || 





Figure 5.3 Selection list for updating records 


A sample format for displaying the UPDATE button 1s presented below: 


"<TABLE COLS=5 BGCOLOR-2-"e8e8c1" ALIGN="CENTER" WIDTH=98%>', 

"<TR><TD WIDTH=60%><TD WIDTH=10%><TD WIDTH=10%><TD WIDTH=10%><TD WIDTH-102»', 
'<TR><TD><TD><TD>', 

"<А href="/cgi-bin/isis3w.exe?rec id-',mfn,'&de worksheet-', 

if vll='AS'then'ASE'else if vll.1='"A'then'AMS'else'MON'fi fi,if p(v500) then v500.1 else 
"ES fi, 

'&database-agris&search type-ef modifyélang=eng">Update</A>', 


As one can see, within the format it is possible to check the “type” of the record (the field 
V11), and according to it one can provide the appropriate worksheet (ASE, AMS or 
MON). 


5. 8. Record ownership control 


The ownership control can be implemented on the BROWSE level and on the validation 
level. In both cases one can use in the format the virtual fields: 


9970 - IP address of the end-user 

9960 - User Identifier (as used for login) 

996] — User privilege groups (as defined in ACCESS.DEF) - this field is repeatable 
9950 - date in the format DD/MM/Y Y Y Y 
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In case of the format for browsing the fields can be used for conditional providing of the 
UPDATE/DELETE buttons, depending on the “ownership field". In the case of the 
validation format an error message can block saving of the "foreign" record. 


If for example the field V20 is used for storing the owner ID of the “owner of the record" 
we can check in the format if the current IP is correct by comparing v20 with V9960: 
If v9960=V20 then 


'<A href="/cgi-bin/isis3w.exe?rec id-',mfn,'&de worksheet-', 

if vll-'AS'then'ASEE'else if vll.1-'A'then'AMSE'else'MONE'fi fi,, 
'&database-demo&search type-ef modify&lang=eng">Update</A>', 
fi 


Note: It is not recommended to control the record ownership if the field for “Ownership 
control" is not write-protected. This means that such a field should be generated 
automatically by the ON NEW function. If the condition is not fulfilled, there is a risk 
that entered manually user Id does not comply to the registered User Id. 


Note: If no login is done, the field 9960 will provide the value unknown. 


Privilege group control 


In a similar way one can control the buttons dependent of particular privilege groups of 

the logged user: 

If v9961:'LOAN' then 

'<A href="/cgi-bin/isis3w.exe?rec id-',mfn,'&de worksheet-LOAN', 
'&database-LOAN&search type=ef copy&lang=eng">LOAN</A>', 

fi 


IP control 


If a function is planned for a given group of users that can be identified by IP, e.g. 
internal or external users, specific button function providing a special worksheet can be 
conditionally displayed only for a given IP. 


Date control 

If a function planned can be performed only within a given period one can use V9950 
(and possibly some dates in the record) to condition displaying the date-dependent 
function button. For example, it can be used for providing trial period for accessing a 
functionality of the system. 


5.9. Mailing tools 


Special tools have been prepared for implementing the feature of generating an e-mail 
when a new record is created. It may be used in various ways: 
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1. Informing a database administrator if a body registers in a database storing 
information on authorities. An example of such an application would be the database 
on information sources, where the interested bodies (focal points) can register an 
institution or a database, and the information on this fact should be automatically 
provided to the co-ordinating center. 


2. Informing a thesaurus administrator on a new term proposals registered in the 
proposals database; 


3. Implementing "ordering feature": a predefined form allows the end-user to specify a 
request for a document (as planned to be implemented at FAO for the FAO 
documents) 


4. Implementing "Loan request", "acquisition request", etc. 


From the end-user point of view it is usually implemented in the form of a link. The main 
idea is that the link performs creating a new record in an ISIS database. When the record 
is committed the CGI program will send an email message to the indicated address (a 
library staff, database administrator, regional center, etc.), where further processing 
concerned with the registered record can take place, or just a request has been logged. 


To this end special set of parameters has been implemented. It 1s possible nowto specify 
the request for Copy, New or update with the parameter mail_fmt. If this parameter is 


present WWW-ISIS having successfully committed saving new/updated record uses the 
indicated format to generate the mail. 


From the end-user point of view, usually there is a link attached to a record. When 
clicked, the system performs the following: 


1. It provides an form (empty or with predefined values) 
2. If filled properly and submitted, the system performs necessary validations. 


3. If everything is correct from the validation point of view the record is saved and the 
mail_format is activated. The format generates all the parameters needed for mailing 
(from, to, reply-to, etc) and the server sends the mail. 


From the implementation point of view it is necessary to: 
1. Add an ISIS database as a "request log" 
2. Define the data entry form and all necessary validation means 


3. Add a link to the main display format 


Example: Provided that the ISIS database is named ORDERS, the worksheet name is 
ORDER, and the mail format is email.pft the following link shows how to use the mail 
mechanism: 


<A href= 
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"Icgi-bin/isis3w.exe?search, typezef new&de worksheet-zorder&database-orders&de mail pft =email&lang=eng"> 
Order the material </А> 


If it is recommended to copy some data from a source record to the ORDER record (e.g. 
accession Number, Author, Title, Call Number, etc.) it is also possible to use the function 


сору: 


«A href-"/cgi-bin/faobib.exe?search typezef copy&de copy initZECLIB &de_worksheet=order&database=faobib 
&rec id2000839&de mail pft Zemail&lang-eng"» Order the material </A> 


The indicated mail format should generate the following structure: 


mail server IP (not name, IP) 

mail server port (usually 25) 

TO: «address» [has to be in line 3, case in "To:" 1s important] 
From: <address> [has to be in line 4, case in "From:" is important] 
Reply-to: <address> 

Subject: <sub ег» 

<new line> 

<new line> 

body of the message 

«empty line» 


For example the following mail could be generated: 


148.81.64.3 

25 

TO: library€tac.org 

From: brown@minagr.gov.uk 
Reply-to: brown@minagr.gov.uk 
Subject: request for a book 


Dear Sir/Madam 

Please send me the FAO document entitled: 

Summary report of and papers presented at the tenth session of the 
Working Party on Fish Technology and Marketing. Asia-Pacific Fishery 
Commission. Working Party on Fish Technology and Marketing. Sess. 10, by 
James, D.G., (ed.). 

Accession Number: 379509. 

The document should be sent under address: 

Wasik Piotr 

Elektronika 

Teatralny 234 

Poland 


Sincerely Yours 
Wasik Piotr 


In the message above the following parameters have been used: 


148.81.64.3 - this is IP of the computer where the mail server is located, to which 
WWW-ISIS has to refer with the e-mail requests. It should be one of the closest mail 
servers 

25 - this is the port of the mail server to which WWW-ISIS refers - usually the mail 
servers use the port 25 
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Tos ера сва синее елее, 

From: brown@minagr.gov.uk 
Reply-to: brown@minagr.gov.uk 
Subject: request for a book 


Those lines are self-explanatory. 


Note: For the proper work of the mailing function it is necessary to add a line to the CFG 
file, defining the SPOOL directory, e.g. 


OrdersMailSpool C:\waicentl\spool 


The spool directory is necessary for the case if the connection to the mail server fails. In 
this case the system will leave the generated mails in the spool directory. After having 
fixed the problem they can be directed (manually) to the mail server. 


Having the parameters generated by the format the cgi program, when successfully having 
added a record to the orders database, it will generate an e-mail with the parameters 
provided, and then will try to connect to the indicated mail server. If succeeded, the mail 
will be passed, otherwise it will be left in the spool directory. 


Special field in the created record (V9970) stores the IP of the end-user, so that one can 
additionally test authorization for the "mailing function". 


5. 10. National coding pages 


With WWW :-ISIS one can maintain the database in a national coding page. To preserve 
the national characters in the inverted file one has to define the ISIS tables ISISAC and 
ISISUC. As in Micro-CDS/ISIS, the table ISISAC should contain a list of all characters 
that should be taken into account when extracting terms to the inverted file, whereas 
ISISUC is used to translate from lower case to upper case (only the first table, 1.e. 256 
characters, 1s taken into account). 


The tables should reflect the selected coding system: it can be either WINDOWS 
standard or ISO. For publishing the database on Internet the ISO standards are 
recommended. The ISIS tables should be stored 1n the database directory. If no table 1s 
provided, the system uses standard ISISAC and ISISUC tables (as defined by UNESCO). 
In such a case one can expect that the national characters are not taken into account when 
building the inverted file. If ISISAC 15 provided, then also ISISUC 15 required for proper 
work of the browse and search functions. 
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5. 11. Data entry interface 


5. 11.1. HTML layout 


When all the worksheets are defined and tested, it is necessary to implement interface 
providing functionality of the data entry system. The menu should contain among other 
functions for login, entering new records, tools for selecting records for update, etc. For 
accessing the records, in general the same retrieval tools can be applied as the ones used 
for building public access to the database. However, the interface designed for public 
access cannot be directly applied for updating databases. In particular the access means 
may differ from the ones foreseen for public interface. For example, in the case of 
designing public interface to a library database we provide search by basic bibliographic 
attributes (Author, title, descriptors, conference data, etc.), whereas data entry staff may 
wish to access records additionally by MEN, ISBN, Accession Number, Call Number, etc. 
Also display formats will differ. On the public interface we may have the functions for 
exporting particular records (as ISO2709 or XML), whereas on the data entry side we 
need function buttons for calling UPDATE, COPY, DELETE. 


Provided that we have already a public access interface we have to perform the following: 
e Upgrade the browse definition table and corresponding display formats 


e Upgrade the search definition table and corresponding display formats 


In this section we will go through the steps leading to the data entry interface. First, let us 
analyze the HTML structure of the demo data entry system. The starting page is de.html, 
which loads as a left frame the file tocde.html, and calls the main frame (display) for 
login. 
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Ж www isis Demo - Netscape 
File Edit мем Go Communicator Help 


Я wt "Bookmarks Æ Location: [http://www isis. org; /Demo/de.html - | QU" What's Related ш 








ч 2 3 2a 2 © с & 8 


Back Forward Reload Home Search Netscape Print Security Stop | 
WebMail Contact People Yellow Pages Download C4 Channels 











DEMO 


Login 


Username: | 
Add new | 
| Journal's paper = ] Password: | 


Update | 
[by browse т | LOGIN | 
Set defaults | 
| Journal's paper  * ] 
LOG IN 
LOG OUT 


AUTHORITY 


Add new | 
| Conference w | 


Update | 
| Conference = ] 


ar == Document: Done = 3 Ux» cy т. | 





Figure 5.4 Login page 


The “display” page 15 generated by the “Frame” statement: 


«FRAME SRC="/cgi- 
bin/isis3w.exe?&search type-ef login&page header=ephmoné&lang=engétable=mons" 
NAME="display"> 


The left frame can be seen as an example menu with basic functions for data entry staff’. 


In this example we have separated selection of main bibliographic worksheets from the 
selection of the authority data. 


5. 11.2.Entering new records 


The selection of a worksheet for entering a new record can be done in the form of a 
combo box by the HTML code: 


<FORM METHOD=POST ACTION="/cgi-bin/isis3w.exe" TARGET="display" 
ENCTYPE-"application/x-www/form-urlencoded"» 


<FONT FACE-"Arial,Helvetica" COLOR=green SIZE-2"2"»«B» 

«BR» 

<FONT FACE-"Arial,Helvetica" COLOR=green SIZE-2"1"» 

«BR» 
<INPUT TYPE="HIDDEN" NAME-"database" VALUE="DEMO"> 
<INPUT TYPE="HIDDEN" NAME="Ssearch type” VALUE-"ST ney" > 
<INPUT TYPE="HIDDEN" NAME-2"lang" VALUE="eng"> 


? It is recommended that you open now the file tocde.html from ~webpages\demo 
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<INPUT TYPE="SUBMIT" VALUE-"Add new"> 

<BR> 

SSELECT NAMEb-"de worksheet" SIZE. ) "> 

<OPTION SELECTED VALUE-"ASEE"»Journal's paper 
<OPTION VALUE="AMSE">Book's paper 

<OPTION VALUE="MONE">Book 

</SELECT> 

</FORM> 


In this code above the parameter database is optional (we marked it by blue). Actually, if 
the database parameter is specified at the entry definition level in entry.def (see Section 
5.1), the specification of the database, as made here, 15 ignored. The obligatory parameters 
are in red. The parameter de worksheet is defined by end-user via the combo-box. 


In a similar way we can define a worksheet selection for defining default values: 


<FORM NAME="formdflt" METHOD-POST ACTION="/cgi-bin/isis3w.exe" TARGET="display" 
ENCTYPE-"application/x-www/form-urlencoded"» 


<INPUT TYPE="HIDDEN" NAME-"database" VALUE="DEMO"> 
<INPUT TYPE="HIDDEN" NAME="search type" VALUE="ef new"> 
<INPUT TYPE="HIDDEN" NAME-"de define defaults" VALUE="1">"° 
<INPUT TYPE="HIDDEN" NAME-"lang" VALUE="eng"> 

<INPUT TYPE="SUBMIT" VALUE="Set defaults"> 

<BR> 

SELECT NAME="de worksheet" SIZE-I)"» 

<OPTION SELECTED VALUE="ASEE">Journal's paper 

<OPTION VALUE="AMSE">Book's paper 

<OPTION VALUE="MONE">Book 

</SELECT> 

</FORM> 


5. 11.3.Updating and copying existing records 
We hope that at this point you are able to prepare the functions for creating new records. 


Now, let us analyze how the access to update existing records has been implemented. On 
the provided menu we have a combo-box with one of the options: browse or search 
function: 


<FORM METHOD=POST ACTION="/cgi-bin/isis3w.exe" TARGET="display" 
ENCTYPE-"application/x-www/form-urlencoded"» 


<INPUT TYPE="HIDDEN" NAME="database" VALUE="DEMO"> 
<INPUT TYPE="HIDDEN" NAME="table" VALUE="emonm"> 

<INPUT TYPE="HIDDEN" NAMF="prefix" VALUE="NM: х GESMONE"> 
<INPUT TYPE="HIDDEN" NAME="format name" VALUE="@ESMONE"> 
<INPUT TYPE="HIDDEN" NAME="lang" VALUE-"eng"» 

<INPUT TYPE="SUBMIT" VALUE="Update"> 

<BR> 

<SELECT: NAME-"Scarch type" GIAE=L> 

<OPTION SELECTED VALUE="browse">by browse 

<OPTION VALUE="entry">by search 

<7 SELECTS 

</FORM> 


I? The frame tocde.html contains worksheet selection constructs for authority data, they 
are done analogically. 
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As one can see, in case of search we refer to the database.def.eng to the “table” 
emonm. This table differs from the search tables designed for public access (mons and 
mona ). 


Also in the case of Browse we refer to table emonm (this time in browse.def.eng). 


Exercise 5.1 


Prepare an HTML file, in which separate buttons are specified for search and for browse 


Please note, that independently of which way of accessing the records 1s selected, the 
display format is the same, and it is @ESMONE. Before we analyze the format, let us 
have a look to the update screen received after selecting Browse option. 





= Ww wisis Demo - Netscape |e} xX) 1 
File Edi Yiew Go Communicator Help | 


B АЁ" Bookmarks E Location: [http: //www.isis. ога: /D emo/de. html x] Qi" What's Related = 
| € € — d з > шш ck ww F | 















Back Forward Reload Home Search Netscape Print Security Stop 
WebMail Contact People Yellow Pages Download Cá Channels 





























DEMO 
Instructions: 
Add new | e To move to a specific position in the list enter the appropriate root of the term in the box. 
[Journal's paper [т] e Click onthe underlined text to view the record. 
Start from: | [TRN -] BROWSE | PgDn | 
[by browse т ] 
Set defaults | i m 
| ournal's paper aj z 
” "e рар View Update Copy 
PL9200001 (MFN-1) 
LAGIN Effect of heat on production and physiological traits in broiler chickens (7?) Herbut, E., Pietras, M. ; 1989 v. 16(2) p. 223-232 
LOG OUT 
AUTHORITY View Update Copy 
PL9200002 (MFN=2) 
Add new | Circadian rythm of nutria activity under farm condition (і) Cholewa, R. ; In: Roczniki Naukowe Zootechmki (Poland) Annals of 
[Corp.body а Animal Science ; 1989 v. 16(2) p. 253-259 
update | | - 
[Corp.body x] View Update Copy 
PL9200003 (MFN=3) 
Frequency of using of bowl and nipple drinkers by nutria (Р?) Cholewa, R. ; In: Roczniki Naukowe Zootechniki (Poland) Annals of 
Ammal Science ; 1989 v. 16(2) p. 261-266 
View Update Copy 
PL9200004 (MFN=4) 
Evaluation of the usefulness of some feeders for nutria (Рі) Cholewa, R. ; In: Roczniki Naukowe Zootechniki (Poland)Annals of 
Å nimal Science - 1989 x 1656(70»^6e ?67.77? P 
id" | D | ‘Document: Done EE DESI, et. | 








Figure 5.5 The page for selecting a record for update 


The format “generating” this page in the part marked by yellow is similar to the format 
@ESMON analyzed in [1] (see Table 5.2). Therefore we will analyze only the part 
presented on blue background. There are four parts distinguished in this area: 


1. Link to the same record to show it in another format - function View (blue font) 
2. Link to the Update function (red font) 

3. Link to the Copy function (green font) 

4. Link to the Copy M->A function (dark green font) 


Let us analyze Update link in more detail. In this link the cgi function (search type)is 
setup to ef modify. One can see that the format with the IF statement specifiess the 
worksheet parameter (de worksheet) according to the record type. 


The link Copy copies some data from a selected record to create a new record of the same 
type. It differs from UPDATE link only by the function (e£ copy) and specifying the 
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copying format parameter de copy init. The worksheet is specified in the same way 
as for Update. 


The link for Copy M->A 15 created conditionally — only if the record is of the M/MS type 
Gf V11.1—' M). It performs copying the monographic part to analytic record. Obvopislu 
the copying format has to be different from the one applied for the function Copy. 


Table 5.2 


"<TABLE COLS=5 BGCOLOR="e8e8c1" ALIGN="CENTER" WIDTH=98%>', 
"STROVTD WIDITHS060s$-«TD NIDPHST0S «TD WIDTH=102><TD WIDTHSTOS-STD WIDTHeSTOS.-', 
HeTRSCTDSeTDS«TDSt. 

'<A href="/cgi-bin/isis3w.exe?rec id-',mfn, 

'&database-demo&search type=link&lang=eng&format_name=EFMONE">View</A>', 
Cap: 

'<A href="/cgi-bin/isis3w.exe?rec id-',mfn,'&de worksheet=', 

if vll='AS'then'ASEE'else if v11.1='A'then'AMSE'else'MONE'fi fi,, 
'&database-demo&search type-ef modify&lang=eng">Update</A>', 
popped 

'<A href="/cgi-bin/isis3w.exe?rec id-',mfn, 
'&database-demo&search type=ef copy&de worksheet-', 

if vll-'AS'then'ASEE'else if v11.1='A'then'AMSE'else'MONE'fi fi, 
'&de copy init=ECALL&lang=eng">Copy</A>', 

if v11.1='M' then 

'<TD>', 

'<A href="/cgi-bin/isis3w.exe?rec_id=',mfn, 
'&database-demo&search type-ef copy&de worksheet-AMSE', 

'&de copy init=ECM2A&lang=eng">Copy М->А</А>', 

ti 

'</TABLE>', 


"<FONT FACE-"Arial,Helvetica" COLOR=BLUE SIZE-2»«B»'v1'«/B»', 
' &nbsp; (MFN='f(mfn,1,0),"')' 
'</FONT><BR>', 


mal, 

if У11.1='А' then 

'<A href = "/cgi-bin/isis3w.exe?rec id-', 
men; 


"Edapabase-duemosssesrau Урва eta == л т ап л=еп ЕС neuge-ERMCONHE'" >", 
yl20, 1f ма (yvl20) then vl122,1£ a(vl22) then vi122,1Ff a(vli24) then vl26 fl,Ffi,Ffl,'«/À» ту 
Hep (uwIBOMpe pem 
[Ic speso m y 
if (7220) or p(v420) then "Be. In: €/B-', 
veru, 
Xf p(vy220) апа p(v120) then "p T fi, 
v420/ 
Е у 
УСЮ) trien у 
LL ОО or qG1v220) or pive20) then и TEI; 
ule uS M. ие 
Er NE T 
E37 
T£ (@ V r00 no Or е or л о pL) 
and ОСО sore (мәс or mss) or р (улоу от Ае teo Wu 
(ж 7 
улл ge welt M eB bI eB 
Елате) then T B АСОВЕ 
(v470) / 
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As we can see in the above format some of the functions are provided conditionally, 
depending on the record type (as in case of Copy M->A). It is not the only possibility for 
conditioning the function links. In some cases it may be important to restrict access to 
some functions to particular users. If for example we store in the records the identifier of 
the "record owner" (login), we can provide the Update link conditionally, only when the 
owner is browsing the database. It is possible because we have at our disposal the virtual 
fields providing some system data: 


9970 - IP address of the end-user 
9960 - User Identifier (as used for login) 
9950 - date in the format DD/MM/ YYYY 


So, if for example the field V20 is used for storing the “record owner" we can check in 
the format the ownership by comparing v20 with V9970: 
If v9970=V20 then 
'<A href="/cgi-bin/isis3w.exe?rec id-',mfn,'&de worksheet-', 
if vll='AS'then'ASEE'else if v11.1='A'then'AMSE'else'MONE'fi fi,, 


'&database-demo&search type-ef modify&lang=eng">Update</A>', 
Ё1 


Note: It is not recommended to control the record ownership if the field “Owner” is not 
write protected. This means that such a field should be generated automatically by the 
ON NEW function. If the condition 1s not fulfilled, there is a risk that entered manually 
user Id does not comply to the registered User Id. 


Note: If no login is done, the field 9960 will provide the value unknown. 


IP control 

If a function 1s planned for a given group of users that can be identified by IP, e.g. 
internal or external users, specific button function providing a special worksheet can be 
conditionally displayed only for a given IP. 
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Date control 

If a function can be performed only within a given period one can use V9950 (and 
possibly some dates in the record) to condition displaying the date-dependent function 
button. For example, it can be used for providing trial period for accessing a functionality 
of the system. 


5. 11.4. Proof format and how to return to the selection list 
One of the useful features is a possibility to display a record just after saving it 
successfully as a new or modified one. The newly saved record can be displayed 1f the 
worksheet definition in entry.def contains the parameter proof pft. Another very 
useful feature could be that having summarized the newly saved record we can return to 
our “selection list for taking another record for update. 


Let us sketch a preferable sequence of actions concerning updating one or more records: 
1. perform a search or browse in order to find a record (list of records) for update; 
2. perform an update of a record selected from the list 
3. checking the record by proof-reading the display by proof format 
4 


return to the list of records (just to the page where we took last record) in order to 
continue updating other records from the list. 


Usually it is not easily to programme such a scenario in the client-server architecture, in 
particular with the cgi technology, as cgi program does not remember “session state" (we 
say that it is stateless). In order to implement the scenario we have added a special “state” 
parameter, which enables WWW-ISIS (which is the cgi program) to return to the list. 
There 18 a special *virtual field" in the displayed record, which stores the "state" of the 
session. It is the field with the tag 9940. To this end we have to: 


l. add the parameter de back to the Browse/search display format 
(‘ае back=',v9940) 

2. define proof format for the worksheets, providing there conditional “function 
key" for RETURN to the list (in the RETURN link we refer again to V9940) 


Below we provide an example of display formats "programming" a scenario for returning 
to the selection list. 
Browse/display format 


Below is a part of the format presented in Table 5.2: 


"<А href="/cgi-bin/isis3w.exe?rec id-',mfn,'&de worksheet-', 
if vll-'AS'then'ASEE'else if vll.1-'A'then'AMSE'else'MONE'fi fi,, 
'&database-demo&search type-ef modify&lang=eng&de_back=' ,v9940">Update</A>', 


The fragment responsible for “storing the “display” state is in black. 


Note: The same should be added to the links for COPY functions. 
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Proof format 


The fragment of a Proof format providing "function keys" 1s displayed below: 


Cet 
"<TABLE COLS=5 BGCOLOR="e8e8c1" ALIGN="CENTER" WIDTH=98%>', 


"<TR><TD WIDTH=60%><TD WIDTH=10%><TD WIDTH=10%><TD WIDTH=10%><TD WIDTH=10%>', 
СТВ Тр TDS" , 
if p(v24) and p(v9940) then 
'<A href="/cgi-bin/isis3w.exe?search type-ef back&de back-',v9940, 
'">Return to selection list</A>', 
fi,'<TD>', 
"<А href="/cgi-bin/isis3w.exe?rec id=',mfn, '&de worksheet=',v4"E", 
'&database-asfa&search type-ef modifyélang=eng','">Update</A>', 
ud» 
"<А href="/cgi-bin/isis3w.exe?rec id-',mfn,'&de worksheet-FULL', 
'&database-asfa&search type-ef modify&lang-eng','"»Update (complete)</A>', 
петр, 
"<А hrerse"/ogi-bin/i1sl62w.exe?reoc id-',mfn, 
'&database-asfa&search type-ef copy&de worksheet-',v4"E", 
'&de copy init-ECALL&lang-eng"»Copy«/A»', 
'</TABLE>', 


The part responsible for “restoring the “display” state is 1n red. Please note that the 
"retun" function (Return to Selection List) is provided by the format conditionally, i.e. 
only when the field V9940 is present and V24 is present. In this example we presume that 
the field V24 is “Date of last update” and can be present only if the record saved was in 
UPDATE (we can have this case if only the format ON_Update creates the field V24, 
whereas the format ОМ NEW does not do it). 


Note: The conditioning in the format is obligatory, otherwise the function would appear 
in the proof display also for the newly created records, while the *search/browse" history 
for new records is empty (which means that using the “return” link may lead to 
unpredictable situations. 


5. 11.5.Login function 


And last but not least, the menu should contain a function for login. This can be done by a 
cgi call: 


<A 


HREF="/cgi-bin/isis3w.exe?database=DEMO&search type-ef login&page header=ephmonélang=engétabl 
e-mona" TARGET="display"> 
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6. HTP files 


The CGI program generates various screens based on special *.HTP files. The HTP files 
provide HTML patterns to the cgi program while generating the HTML pages. There are 
HTP files that are used to create search screens as well ass those used to create data entry 
screens. 


6.1. Search and browse related HTP files 

The following HTP have to be predefined: 

e  search.htp — used for building the seach forms 

e result.htp — used for building the result page 

e thes.htp — used for building the page with a bag for collecting the selected terms from 


thesaurus 
e view.htp — used for building the history and EDIT ISIS QUERY pages. 


The particular lines of the HTP files are compatible with the HTML, however the HTP as 
whole is not the HTML page. 


The lines are built according to the following rules: 
e Fach line starts with a number preceded by #. 


e The numbers must grow consecutively. If one want to make a comment, the comment 
line should start with a semicolon. 


e The line can be continued in the next line, in this case one has to end the line with the 
character “\” and continue the line from the position 22). 


6.1.1. Search HTP 
Some most important lines in search.htp are: 


e line #10 can be used for the page header when the search page is created. It contains 
as a title the text from database.def.eng (naming given "record type"); 


e lines #30-#45 define the HIDDEN parameters on the search page 


e lines #50 - #52 define the table with function keys. In particular the keys are defined 
in the lines 50-51. In case of the Windows version the following keys can be defined: 
Search, ISIS-QL, Clear, Undo. For the Linux version only the keys Search and Undo 
can be defined. The line 52 is used for the checkbox controlling "exact/non-exact 
match of words" search. 
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e lines #54 - #55 can be used as an extra text below the table with the keys; 


e lines #60-61 define the text area line for the searching fields (once for all), line 62 
defines AND/OR combo-box for the line; 


e lines #63-65 define the combo box for searching ) type 2 in database.def (once for all) 


e lines #70- #73 define the buttons for the selecting data from a combo box received 
after having pressed presses the LIST button (old LIST function, working when the 
ListCheckBox 15 set to 0) 


e lines #120- #125 define the buttons for the selecting data from a LIST page received 
after having pressed presses the LIST button (new LIST function, working when the 
ListCheckBox is set to 1 - only Windows version) 


e line #85 defines AND/OR/NOT radio buttons between the fields 


e lines #95 and #96 define sort and format combo- boxes respectively; 


e Lines #131- #133 define checkboxes for the "multi-database search; 
e line #157 end of table 
e line #160 end of form 


e [ines #180 and #181ldefine bottom of the page for an extra text (explanations, e-mail 
for comments, etc) 


A sample HTP file for the search screen 1s provided in Annex. 


Please note that in standard installations there is no need to modify the HTP. In particular 
cases the modifications may refer to the colors, proportions of the tables, descriptive texts, 
etc. It a multilingual version is being prepared, the HTP file has to be translated. 


Additional lines for the newest version of the system 


Multidatabase search 

#129 <TABLE><TR><TD COLSPAN=3>Database selection for <B>%s</B></TD><TR> 
#130 <TR> 

1131 <TD> Search In:«/TD» 

#132 <TD COLSPAN=2> 


1133 <B>%s</B><INPUT TYPE="CHECKBOX" NAMF="database"\ 
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VALUBSe"SE" СЕ OnClick="cp QIIGRILhIS)" ирер 
#134 <B>%s</B><INPUT TYPE="CHECKBOX" NAME-"db select database"\ 
VALUBS"SÓa" св OnClick="ebp click (this) "> кирер; 
$135 </TD> 
#136 </TR> 
#137 <TR><TD COLSPAN-3 ALIGN=CENTER><SMALL><INPUT NAME="SAVE" TYPE="SUBMIT"\ 


VALUES"SAVE" TITLE="Save database selection" ></TD><7/TR></TABLE> 


#138 <P>Database selection saved. 


Multi-attribute fields on the search screen 
#152 <TR><TD class="maincolor'><BS><SMALLS<SELECT NAMES"Zs92s" SIZE=1> 
#153 <OPTION $s VALUE-2"$d"»$s 
#154 </SELECT></SMALL></B></TD> 
#155 «TD class='maincolor' NOWRAP><INPUT TYPE="TEXT" \ 
NAME="%S" SIZE-45 MAXLENGTH-150 VALUE="%s"> 


6.1.2. Browse HTP 


e line #10 can be used for the page header when the browse page is created. It contains 
as a title the text from browse.def.eng (naming given "record Туре”); 


e lines #30-#38 define the HIDDEN parameters on the browse page 


e lines #40-#43 define the text field for "goto" parameter and the buttons on the browse 
page (BROWSE, PgDN, etc.) 


e line #50 can be used to define a comment following the text field; 


e #90- #91 define the selection combo-box for choosing the way of browsing 


e line #179 can be used as another comment on how to use the BROWSE function 


6. 1.3. Result HTP 


e line #10 can be used for the page header when the result page is created. It contains as 
a title the text from database.def.eng (naming given “record Туре”); 
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lines #49-#53 define the links for paging the results; 


lines 4191-5188 define possible errors. 


For the new export functionality the following parameters can be used on the export 
pages: 


export fst — the variable determines a predefined fst, to be used for fst controlled 
generation of 1502709; if the value of the parameter is set as "dynamic", the system 
provides a selection page based on the FTD 


export fst template — the variable defines a form which is used to build the selection 
lines. The use of the variable is optional, the default use by the system is 
(Vexport fdt tag/). The variable can be defined as hidden. If in the target field we 
want to save the original name we can use in the template the variable 
Export fdt name (this feature 15 more for РЕТ generation and does not seem to be 
usable for generating 1502709) 


The variable "search. type" may have now new value "export mfn submit fdt" to 
indicate that export will be controlled by selection from FDT 


export pft may have now the value “dynamic”, if we plan providing the field selection 
to the end user based on the FTD; 


export pft template — the variable defines a form which is used to build the PFT lines. 
The variable can be defined with the use of two variables Уехрогі fdt tag and 
Export fdt name. 


Example: 


<INPUT TYPE="HIDDEN" NAME-"export pft template" VALUE=" (&quot;<TR><TD VALIGN-TOP 
cGlass-'marncolor'o«B»«l-Export fdt.name:«/lI^«/B»«TD-^&quot;Vexport fdt bcagt]z- Dy£,"5 
Please note that in order to avoid HTML errors we use &quot; to indicate double 
quote (^^) for the definition of the display format literals; 

The variable "search. type" may have now new value "export mfn submit fdt" to 
indicate that export will be controlled by selection from FDT 


Export of ISO2709 by range 
For export by range there are two “sections” in result .htp that require changing: 


a. The part responsible for the first screen 
b. The part responsible for the field selection screen (needed only if we foresee 


dynamic FST creation from the end-user choice) 


As in previous versions, the first screen (a) 1s controlled by the lines 110- 130. An 
example is given below: 
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#110 «BODY BGCOLOR=#FFFFFF>\ 
<TABLE WIDTH="80%" CELLSPACING=0 CELLPADDING=0 BORDER=0>\ 


<TR><TD BGCOLOR="e8e8cc" ALIGN="LEFT"><FONT SIZE="4+1" 
FACE="Arial,Helvetica"><B>énbsp; Download/print records</B></FONT></TD>\ 


</TR></TABLE> 


FOE IF ЖОЛУ TF UI TF UI TF IF TF TF TF АЕ ЭШ ДЕ Ж | Ж YF 9 Ж Ж Ж 9 | Y | Y 1| 01. 01 1 1 Ж 


Pii SUESUSETESESS in the line #112 the value export FST is needed if the export is planned by FST. The 
selection of FST can be also provided ;;; 


2:ii ##{######4#4{4 ру a check box see #127. Another new form is that with the value "dynamic" the user 
can define his/her own fields for download ;;; 


FF IF IF T TF UI TF I TF I T I TF TF TF FL АУК FL ЖТ. ҮҮТ g v | ҮҮ ЖОЮ КОЮ Y 1. КО 1 10 ЖО YF 


#112 «FORM METHOD=POST ACTION="/cgi-bin/isis3w.exe" ENCTYPE-"application/x-www/form-urlencoded" 
NAME-"export results form">\ 


<INPUT TYPE="HIDDEN" NAME-"lang" VALUE="@lang@">\ 
<INPUT TYPE="HIDDEN" NAME-"search type" VALUE-"export mfn submit">\ 
«INPUT TYPE-"HIDDEN" NAME-"export pft" VALUE="">\ 
<INPUT TYPE="HIDDEN" NAME-"export ext" VALUE-"iso"» 
;;; if no selection for FST is provided a lina as below is sufficient 


КЕ; SINPUT TYPE="HIDDEN" NAME-"Gxport fst" VALUE-"Test,TISst"S 


#114 <INPUT TYPE="HIDDEN" NAME="%$s" VALUE-"$s"» 


#115 

#116 <TABLE BORDER=0><TR> 

#117 

#118 

#119 

#120 «TD ALIGN="LEFT" BGCOLOR="e8e8c1">\ 


<FONT FACE-"Arial,Helvetica" SIZE="-1"><B>énbsp; Select 
databaseénbsp; </B></FONT></TD><TD>é&nbsp; </TD>\ 


<TD><INPUT TYPE="RADIO" NAME-"database" VALUE="@database@" CHECKED>\ 
<B><FONT FACE-2"Arial,Helvetica" SIZE="-1">LIBCAT</B><BR>\ 
</TD></TR> 

#121 


#122 <TR><TD><P></TD></TR> 


#123 <TR><TD ALIGN="LEFT" BGCOLOR="e8e8c1">\ 


<FONT FACE="Arial,Helvetica" SIZE="-1"><B>&nbsp;Select mfn 
range&nbsp;</B></FONT></TD><TD>&nbsp;</TD>\ 


<TD><INPUT TYPE="TEXT" NAME-"export mfn from" VALUES"" SIZESB-N 
— <INPUT TYPE="TEXT" NAME-"export mfn to" VALUE="" SIZE=8>\ 
</TD></TR> 


#124 <TR><TD><P></TD></TR> 


#125 <TR><TD ALIGN="LEFT" BGCOLOR="e8e8c1">\ 
<INPUT TYPE="HIDDEN" NAME-"export ext" VALUE="iso">\ 


<FONT FACE-"Arial,Helvetica" SIZE="-1"><B>énbsp;Select file 
type&nbsp; </B></FONT></TD><TD>&nbsp;</TD>\ 
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<TD><INPUT TYPE="RADIO” NAME="export туре" VALUE-"iso" CHECKED 
OnClick="window.document.export results form.export ext.value='iso';">\ 


<B><FONT FACE-2"Arial,Helvetica" SIZE-2"-1"»5ISO 2709</B><BR>\ 


<INPUT TYPE="RADIO" NAME="export type" VALUE="txt" 
OnClick-"ywindow.document.export results form.export prft.value-'text.prt';window.dooument.export results 
 form.export ext.value-'lst';"» 


<B><FONT FACE-2"Arial,Helvetica" SIZE="-1">TEXT</B><BR>\ 


<INPUT TYPE="RADIO" NAME="export_ type" VALUE="txt" 
OnClick="window.document.export_ results form.export pft.value='xml.pft';window.document.export results 
form.export ext.value-'lst';"»V 


<B><FONT FACE-"Arial,Helvetica" SIZE="-1">XML</B><BR>\ 


<INPUT TYPE="RADIO" NAME="export type" VALUE="txt" 
OnClick="window.document.export results form.export pft.value='contr.pft'; 
window.document.export results form.export ext.value-'html';"»^ 


<B><FONT FACE-2"Arial,Helvetica" SIZE="-1">CONTR</B><BR>\ 
<INPUT TYPE="RADIO" NAME-"export type" VALUE="txt"\ 
OnClick="window.document.export results Torm. export pft.value-'dynamic'; 
window.document.export results form.export ext.value='txt';">\ 
<B><FONT FACE-"Arial,Helvetica" SIZE="-1">Select by user</B><BR>\ 
</TD></TR> 
#126 
#127 <TR><TD><P></TD></TR>\ 
<TR><TD ALIGN="RIGHT" BGCOLOR="e8e8c1">\ 


<FONT FACE-"Arial,Helvetica" SIZE-"-1"»«B»&nbsp;Select FST file&nbsp; (for ISO 2709 
only)«/B»«/FONT»«/TD»«TD»&nbsp; «/TD»N 


<TD><INPUT TYPE="RADIO" NAME="export fst" VALUE="test.fst" CHECKED>\ 
<B><FONT FACE="Arial,Helvetica" SIZE="-1">Predefined FST </B>\ 
</TD><TD><INPUT TYPE="RADIO" NAME-"export fst" VALUE="dynamic">\ 
<B><FONT FACE-"Arial,Helvetica" SIZE="-1">Selection by the user</B>\ 


</TD></TR> 
#128 


#129 


#130 </TABLE> 


Download/print records 


Select database © LIBCAT 

Select mfn range | Е | 
© ISO 2709 

Select file type : rd 
© CONTR 


Select FST file (for ISO 2709 only) © Predefined FST © Selection by the user 


DOWNLOAD 


The HTP lines as above give the screen: 
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The screen above can be invoked by a DOWNLOAD button from the menu frame, with 
the HTML as below: 


<td ALIGN=CENTER BGCOLOR="#E8E8C1"> <BR> 

<FORM METHOD=POST ACTION="/cgi-bin/isis3w.exe" TARGET="display" 
ENCTYPE-"application/x-www/form-urlencoded"» 
<font face="Arial" color="green" size="2"><b> 
<INPUT TYPESUHIDBEN". NAME=" search гуре" VALUR="exporl itm" 
<INPUT TYPE="HIDDEN" NAME-"database" VALUE-"libcat"» 
<INPUT TYPE="HIDDEN" NAME-2"lang" VALUE="eng"> 
<INPUT TYPE="SUBMIT" VALUE="DOWNLOAD"><BR><BR> 


</FORM> <b> 


Of course any other layout can be defined within the lines 110 -130. Another part in htp is 
needed for the screen providing selection of the fields. The lines responsible for the 
dynamic selection are 140-154. 


#140 <BODY BGCOLOR=#FFFFFF>\ 
<TABLE WIDTH="80%" CELLSPACING=0 CELLPADDING=0 BORDER=0>\ 


<TR><TD BGCOLOR="e8e8cc" ALIGN="LEFT"><FONT SIZE="+1" FACE="Arial,Helvetica"><B>énbsp; Export 
records based on FDT</B></FONT></TD>\ 


</TR></TABLE> \ 


<FORM METHOD-POST ACTION="/cgi-bin/isis3w.exe" ENCTYPE-"application/x-www/form-urlencoded" 
NAME-"export results form">\ 


<INPUT TYPE="HIDDEN” NAME-"export ext" VALUE="iso">\ 

<INPUT TYPE="HIDDEN" NAME-"lang" VALUE="@lang@">\ 

<INPUT TYPE="HIDDEN" NAME="search type" VALUE-"export mfn submit fdt">\ 
<INPUT TYPE="HIDDEN" NAME="export type" VALUE="@export type@">\ 


<INPUT TYPE="HIDDEN" NAME-"export pft" VALUE="">\ 




















<INPUT TYPE="HIDDEN" NAME="database" VALUE="@database@">\ 
;;;;; the line below has a default value for generating FST for export 
$ <INPUT TYPE="HIDDEN" NAME-"export fst template" VALUE-'(Vexport fdt tag/)'»^ 


;;;;; the line below is an example for generating tag text file - note that double quot has to be 
coded !!! 


<INPUT TYPE="HIDDEN” NAME="export pft template” VALUE=" (&quot;<TR><TD VALIGN=TOP 
class='maincolor'><B><I>Export fdt name:</I></B><TD>&quot;Vexport fdt tagt|; |)/,"»^ 


<INPUT TYPE="HIDDEN" NAME-"export mfn from" VALUE="@export mfn from@">\ 
<INPUT TYPE="HIDDEN" NAME-"export mfn to" VALUE="@export mfn to@"> 
#141 
#142 <TABLE BORDER=0> 


#143 





#144 <TR><TD ALIGN="RIGHT" BGCOLOR="e8e8cl1">\ 


<FONT FACE-"Arial,Helvetica" SIZE="-1"><B>énbsp; Selected 
databaseénbsp; </B></FONT></TD><TD>é&nbsp; </TD>\ 


<TD><B><FONT FACE="Arial,Helvetica" SIZE="-1">@database@</B>\ 
</TD></TR> 


#145 
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#146 <TR><TD ALIGN="RIGHT" BGCOLOR-"e8e8c1"»* 


<FONT FACE-"Arial,Helvetica" SIZE="-1"><B>énbsp;Selected mfn 
range&nbsp; </B></FONT></TD><TD>&nbsp; </TD>\ 


<TD><B><FONT FACE-"Arial,Helvetica" SIZE="-1">@export mfn from@ - @export mfn to@</B>\ 
</TD></TR>\ 
</TABLE> 

#147 

#148 <P><TABLE WIDTH="80%" CELLSPACING=0 CELLPADDING=0 BORDER=0>\ 


<TR><TD BGCOLOR="e8e8cc" ALIGN="LEFT"><FONT SIZE="+1" FACE="Arial,Helvetica"><B>énbsp; Select 
fields</B></FONT></TD>\ 


</TR></TABLE> 
#149 
#150 <TABLE CELLSPACING=2 CELLPADDING=2 BORDER=0> 
#151 <TR><TD ALIGN="RIGHT" BGCOLOR="e8e8c1">\ 
<FONT FACE-"Arial,Helvetica" SIZE="-1"><B>é&nbsp; %5&прзр; </B></FONT></TD><TD>é&nbsp; </TD>\ 
<TD><INPUT TYPE-"checkbox" NAME-"export fdt field" VALUE-"$d" CHECKED» 
</TD></TR> 
#152 </TABLE> 
#153 


#154 <P><TABLE WIDTH-"80$" CELLSPACING-0 CELLPADING-0 BORDER=0><TD ALIGN="center" 
BGCOLOR="e8e8cc"><INPUT TYPE="SUBMIT" NAME-"export" VALUE="EXPORT"></TD></TABLE> 


Export records based on FDT 


Selected database libcat 
Selected mfn range 1 - 100 


Select fields 
Record 1а 
Bibliographic level 
Report number - M lev. 
Library call number 
ISBN 
ISSN 
Personal Author - А lev. 
Personal Author - M lev. 
Corp. Author - А lev. 
Corp. Author - M lev. 


For this htp the sample screen with selection is as on figure below: 


«ЕКЕ [S] [S]. [S] [s]. [s] [s] [s] 
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[s] 


Project Summaries & Recomm 
No of copies 

Date of last input 

Date of last update 

Record status 


Is] [s] 


Is] [Є 


EXPORT 


Note: The export by range can be performed only for one database 


Export of ISO2709 for a given answer 


For exporting a given answer there are two “sections” in result .htp that require changing: 


a. The part responsible for the first screen 
b. The part responsible for the field selection screen (needed only if we foresee 
dynamic FST creation from the end-user choice) 


As in previous versions, the first screen (a) 1s controlled by the lines 80 - 105. An example 
is given below: 


#80 «BODY BGCOLOR=#FFFFFF> 
#81 «TABLE WIDTH="80%3" CELLSPACING=0 CELLPADDING=0 BORDER=0> 
#82 <TR> 


#83 «TD BGCOLOR="e8e8cc" ALIGN="LEFT"><FONT SIZE="+1" 
FACE="Arial, Helvetica"><B>é&nbsp; Download results</B></FONT></TD> 


#84 </TR></TABLE> 
#85 
#86 


#87 «FORM METHOD=POST ACTION="/cgi-bin/isis3w.exe" ENCTYPE-"application/x-www/form- 
urlencoded" NAME-"export results form"» 


#88 <INPUT TYPE="HIDDEN" NAME-"database" VALUE="@database@">\ 
<INPUT TYPE="HIDDEN" NAME-"table" VALUE="@table@">\ 
<INPUT TYPE="HIDDEN" NAME-"lang" VALUE="@lang@">\ 
<INPUT TYPE="HIDDEN" NAME-"selmfn" VALUE="@selmfn@"> 
<INPUT TYPE="HIDDEN" NAME-"export pft" VALUE="">\ 
<INPUT TYPE="HIDDEN" МАМЕ="%5" VALUE="%s">\ 


<INPUT TYPE="HIDDEN" NAME-"export ext" VALUE="iso">\ 





#89 <INPUT TYPE="HIDDEN" NAME-"search type" VALUE-"export submit"> 
#90 

#91 <INPUT TYPE="HIDDEN" NAME-"$s" VALUE="%s"> 

#92 

#93 


#94 <TABLE BORDER=0><TR> 
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#95 <TD ALIGN="LEFT" BGCOLOR-"e8e8c1"»* 


<FONT FACE-"Arial,Helvetica" SIZE="-1"><B>&nbsp;Select scope of 
downloadé&nbsp; </B></FONT></TD><TD>é&nbsp; </TD>\ 


<TD><INPUT TYPE="RADIO" NAME="export select" VALUES'all" CHECKED>\ 
<B><FONT FACE="Arial,Helvetica" SIZE="-1">All records from query</B><BR>\ 
<INPUT TYPE="RADIO" NAME="export select" VALUE="selected">\ 

<B><FONT FACE-"Arial,Helvetica" SIZE="-1">Selected records</B><BR>\ 
</TD></TR> 

#96 <TR><TD><P></TD></TR> 

#97 

#98 


;One of the lines 99 should be entered if one wants to provide an FST for exporting 
1502709 (the first is without selection) 


; #99 <INPUT TYPE="HIDDEN" NAME-"export fst" VALUE="test.fst"> 
#99 <TR><TD><P></TD></TR>\ 
<TR><TD ALIGN="RIGHT" BGCOLOR-2"e8e8c1"»N 


<FONT FACE-"Arial,Helvetica" SIZE="-1"><B>é&nbsp;Select FST 
fileénbsp;</B></FONT></TD><TD>énbsp; </TD>\ 


<TD><INPUT TYPE="RADIO" NAME="export fst" VALUE="test.fst" CHECKED>\ 
<B><FONT FACE="Arial,Helvetica" SIZE="-1">Predefined fst</B>\ 
</TD><TD><INPUT TYPE="RADIO" NAME="export fst" VALUE="dynamic">\ 
<B><FONT FACE="Arial,Helvetica" SIZE="-1">Selected fields</B>\ 


</TD></TR> 


#100 <TR><TD ALIGN="LEFT" BGCOLOR="e8e8c1">\ 


<FONT FACE="Arial,Helvetica" SIZE="-1"><B>&nbsp;Select export 
type&nbsp;</B></FONT></TD><TD>&nbsp;</TD>\ 


<TD><INPUT TYPE="RADIO" NAME="export type" VALUE-"iso" >\ 
<B><FONT FACE="Arial,Helvetica" SIZE="-1">ISO 2709</B><BR>\ 
<INPUT TYPE="RADIO" NAME="export type" VALUE="pft" CHECKED>\ 


<B><FONT FACE="Arial,Helvetica" SIZE="-1">TEXT file, using: 
&nbsp; &nbsp; &nbsp;</B>\ 


«SELECT NAME="export pft">\ 
<OPTION VALUE-"textl.pft"»Short format\ 
<OPTION VALUE="text2.pft">Full format \ 
<OPTION VALUE-"repd.pft"»Delimited format\ 
<OPTION VALUE="efmon.pft">HTML format \ 
<OPTION VALUE="dynamic">User selection\ 
</ SELECT >\ 
</TD></TR>\ 
<TR><TD ALIGN="LEFT" BGCOLOR="e8e8c1">\ 


<FONT FACE="Arial,Helvetica" SIZE="-1"><B>&nbsp; Sort: 
&nbsp;</B></FONT></TD><TD>&nbsp;</TD>\ 


<TD><SELECT NAME="sort name" SIZE=1>\ 
<OPTION VALUE="SCHR"> by Year\ 


<OPTION VALUE="SAUT"> by Author\ 
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<OPTION VALUE="STIT"> by Title\ 
<OPTION VALUE="SCN"> by Call. No\ 


</SELECT></TD></TR>\ 


#101 </TABLE> 

#102 

$103 

#104 

#105 <P><TABLE WIDTH-"80$" CELLSPACING-0 CELLPADING-0 BORDER=0><TD ALIGN-"center" \ 


BGCOLOR="e8e8cc"><INPUT TYPE-"SUBMIT" NAME-"export" VALUE="Download"></TD></TABLE> 


For this htp the first download screen is as below’: 


Download results 


($ All records from query 


Select scope of download E Serie rose 
Select FST file (Only for 1$02709) © Predefined fst © Select fields 
Select export ty P 

IEEE ы ай © TEXT file, using: 3 


The second screen is defined in the lines165-170. The provide the screen the same as for 
the selection by MENs. The possible lines are provided below: 


#165 «BODY BGCOLOR=#FFFFFF>\ 


<TABLE WIDTH="80%" CELLSPACING-0 CELLPADDING=0 BORDER=0>\ 


<TR><TD BGCOLOR="e8e8cc" ALIGN="LEFT"><FONT SIZE="+1" FACE="Arial,Helvetica"><B>&nbsp;Export 
results - select fields</B></FONT></TD>\ 

</TR></TABLE> \ 

<FORM METHOD=POST ACTION="/cgi-bin/faobib.exe" ENCTYPE="application/x-www/form-urlencoded" 


NAME-"export results form">\ 
<INPUT TYPE="HIDDEN" NAME-2"database" VALUF="@database@">\ 


<INPUT TYPE="HIDDEN" NAME-"table" VALUE="@table@">\ 


I! Please note that the example of this screen is not for a practical use but for illustrating the way of 
defining new functions. More reasonable could be repeating the structure for the FST selection as combo- 
box, similar for the format choice. 
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<INPUT TYPE="HIDDEN" NAME-"lang" VALUE="@lang@">\ 
<INPUT TYPE="HIDDEN" NAME-"page header" VALUE="@page_ header@">\ 
<INPUT TYPE="HIDDEN" NAME="selmfn" VALUE="@selmfn@">\ 


<INPUT TYPE="HIDDEN" NAME="export select" VALUE="@export select@">\ 




















<INPUT TYPE="HIDDEN” NAME-"search type" VALUE-"export submit fdt"» 
#166 
#167 «TABLE CELLSPACING-2 CELLPADDING-2 BORDER=0> 
#168 <TR><TD ALIGN="RIGHT" BGCOLOR="e8e8c1">\ 
<FONT FACE-"Arial,Helvetica" SIZE="-1"><B>é&nbsp; %s&énbsp; </B></FONT></TD><TD>é&nbsp; </TD>\ 
<TD><INPUT TYPE-"checkbox" NAMB="export fdt field" VALUE-"$d" CHECKED» 
</TD></TR> 


#169 </TABLE> 


#170 <P><TABLE WIDTH-"80$" CELLSPACING-O CELLPADING=0 BORDER=0><TD ALIGN="center" 
BGCOLOR="e8e8cc"><INPUT TYPE="SUBMIT" NAME-"export" VALUE="EXPORT"></TD></TABLE> 


6.1.4. View HTP 
Providing number of found hits for each database (View.htp) 
#80 <TR ><TD ><FONT SIZE=+1><B>%d</B></FONT></TD><TD WRAP Width='400'\ 
BGCOLOR="CCCC99"><FONT SIZE=-1><B>énbsp; tsénbsp;</B>\ 
</FONT></TD><TD width-200 WRAP BGCOLOR-"CCBB99"»«B»&nbsp;$s&nbsp;«/B»«/TD» 
#81 «TD» «Font SIZE--1 > <INPUT  TYPE-"BUTTON" NAME-"viewquery" \ 
VALUE="VIEW QUERY"\ 
onClick="window. open (\ 


>» + ы 
bin/isis3w.exe?search type-view query historyédatabase=@database@étable=Ctable@s 
page header=@page header@ésort name=@sort name@&lang=@lang@&query no=%d"', \ 

'View Query', 'width=610,height=400, toolbar=yes, location=no,status=no, \ 


menubar=no, scrollbars=yes, resizable=yes') ;"></TD></TR> 


#82 SS 
#83 &nbsp; ($1d) &nbsp; 


6.1.5. Thes HTP 


e lines #30 -#36 define all hiden values that are needed for the rightmost window of the 
thesaurus search screen 


e lines #40-#41 define the text area where the terms are cumulated; 


e lines #42-#44 define the buttons on the thesaurus selection screen (SEARCH, EDIT 
QUERY, CLEAR.) 
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6.2. Data entry HTP files 
The main HTP files for data entry are:: 


e  E-forms - defining details of the data entry worksheet 


e E-browse - defining the necessary HTML fragments of the screen for browsing the 
field contents to be selected to a field; 


Note: Also the HTP that are used for search might be useful for building pages of the data 
entry subsystem. They can be used for making possible selection of records for update 


Below we describe in detail the E-form HTP. The HTP file E-browse is very similar to 
BROWSE.HTP and will not be discussed here. 


6. 2.1. E-forms HTP 


e line #3 can be used for the page header; 
e lines #20-#29 define all the hiddens for the data entry page 
e lines #30-#41 define the buttons on the page for the data entry; 


e lines #42-#49 define the lines for the main table containing the particular data entry 
elements; 


e lines 50-59 define the text field and possible buttons that may accompany the field; 


e lines #60-#69 define the text area and possible buttons that may accompany the text 
area; 


e lines #70-#79 define simple combo-box and possible buttons that may accompany the 
data entry element; 


e lines #80-#89 define multi-choice combo-box and possible buttons that may 
accompany the data entry element; 


e lines #90-#99 define check-box and possible buttons that may accompany the data 
entry element; 


e lines #100-#109 define radio buttons and possible buttons that may accompany the 
data entry element; 


e lines #110-#119 define a comment type field; 
e lines #120-#123 define DELETE confirmation message 


e lines #130-#143 define the warning and error lines that may be produced by the delete 
validation procedure. 
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lines #150-#163 define the warning and error lines that may be produced by the global 
validation procedure. 


lines #170-#173 define a message on saving a record; 


lines #180- #209 define the LOGIN screens 
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6. 2.2. 
7. WWW-ISIS cgi parameters 


7.1. Search subsystem 


If one wants to refer from web to the CGI program he/she can “talk” to the CGI program 
using the language it can understand, i.e. when referring to the CGI program one has to 
provide the parameters which are understood by the program. The parameters can invoke 
a query or data entry questionnaire, provide a query to be serviced by the program, or 
invoke any other function. Please note that the server does not keep the status of the 
client(s) interaction, so usually the interaction 1s “programmed” (or in more appropriate 
terminology, hidden) in the forms invoked, or in the output generated by ISIS (this is done 
by appropriate ISIS display formats). If the system designer wants to design a session 
scenario he/she has to use the “links” that properly invoke the CGI program. The links 
contain relevant parameters to the CGI program. For search and browse functions the 
following <name-value> pairs are defined for the CGI program and may be used in 
building the links (which may be provided on the static HTML documents or in ISIS 
format ^): 


Table 7.1 Search and Browse parameters 


search. type- Indicates the type of operation: 
version info | cgi program version info 
entry | generate empty search form 
dynamic | regenerate search form 
link | access a record by MEN (see rec. id) 
query | generate record from arbitrary query 


list | generate search list from "LIST" button 


browse | browsing a database 


add thes word | add word form thes. to clipboard 
clear thes | clean thes. Clipboard 


export. submit | both parameters should be used on the “export 
page": (1) if the search result is subject to 
export/download, and (2) if the download 1s by 
MEN range (for other parameters see Table 7.2 


export mfn submit 





^ The latter will also give an HTML document with a link but in this case the link will be made 
dynamically and this in fact 1s a real power of using ISIS as a database server in web. 
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database= project, cds, etc Different databases can be handled by the 
interface, hence database name must be 


specified. 





table= as specified in the|it refers to the record type, as specified in 
database ^ definition | definition table 
(e.g. LEX, etc.) 


lang= o egens o eng language - see notes on files allocation. 


c NN name- === output format name, this сап be a SELECT ог 
HIDDEN contruct, see description of database 
definition 


sort name- <string> sort header format; this can be a SELECT or 
HIDDEN contruct, see description of search 
definition table 


page_ — — JS arbitrary format name passed to Isis and used to 
nem HTML page header in result file 


uu header- | <string> arbitrary format name passed to Isis and used to 
generate HTML record header in the result file; 
please note that to format the record we can use 
actually two formats (record header format and 
record format) 


Qmr <integer> Query Max answeR size (number of records), 
overwrittes the corresponding cfg file parameter 

Term <string> prefix, used when one of the search terms 15 
expanded into the pulldown list. 

First <string> Together with “last” hold the range of the 
pulldown list values, to enable “PgDn” and 
е ae scrolling 

NIS Ls ANN original value of the text field to be expanded 
into a pulldown list, used to return to original 
value when the “cancel” button is pressed 

thesaurus- yes = no If "yes" the "pick it up" buttons will be 
= etes in the thesaurus output 


т <string> a word from thesaurus bound to the "pick it up" 
button; when the user click on the button the 
parameter value will be taken to the collected 
list 

bind name, used to link thesaurus to a query 
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Rec id- «integer? The MEN of the record to be accessed (used in 
case when the type of request is link) 


Example 1 


Below is an example of a static link for browsing a thesaurus 


HREF-"/cgi-bin/unep?search type-browse&database-UNEP&thesaurus-no&prefix-SW:&format name=@ 
ESSRC&start term-&lang-eng" 


As one can see we specify here search type parameter as browse, database as 
UNEP (this is the name of an ISIS database), the prefix for browsing is specified as SW:, 
and then format name, start term and language are specified. 


Example 2 


The link below provides a binding for the descriptor AVERMECTINS to be used in a 
search according to that binding 


Href-cgi-bin/faobib.exe?search type-add thes word&bind-bind2 
&cgibin-faobib.exe&thes word-AVERMECTINS&lang-eng 


Example 3 


Here we provide an example of a dynamic link for picking up a record from the thesaurus 
database (the ISIS name is THES) having record, 11=224 (this is MEN) and displaying it 
in the format EL4.PFT, preceded by the record header format EP4.PFT 


HREF = 


"/cgi-bin/envoc?rec id-000224&database-THES&search type-link&table-descriptors 
&lang-eng&format name=@EL4épage header=@EP4" 


This link refers to a particular record. This link is an example of a dynamic link that can 
be generated by formatting record with MFN=224. 


Example 4 


As a next example of a link we show a query (it can be dynamically built from a record, 
e.g. by using the field Main subject): 
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littpi// 
faocd.fao.org:10000/cgi-bin/faobib.exe?query-D$3DHISTORY&database-faobib 


&search type-query&table-mona&page header-ephmon&lang-eng 


In this example the search function is query, so the script will perform searching in the 
database faobib by the query d-history. The output will be formatted by the first 
format from the table MONA. The page header will be formatted by EPHMON. 


Additional set of parameters refers to the export/download functions. The parameters are 
defined in the table below 


Table 7.2 Export/Download parameters 


export type Iso | txt If the export type 1s 1so the system will generate 
the file in the form ISO2709. If the value of the 
parameter is txt, the system will generate a file 
according to the PFT specification 
export. pft Any name of the The parameter 1s needed if the value of 
format for export type 15 txt, in the case of 
generating the export type-iso the parameter is ignored 
downloaded file 
export ext Text defining The parameter defines the extension of the 
output file output file. If the output file 1s ISO 2709 it can 
extension, e.g. be iso. If the output is a text, the value can be txt 
150 


file header The name of the The format should generate a common part that 
PFT to generate the |starts the output file, for example if the output 1s 
file header. to be RTF, the format should generate all the 
necessary RTF definitions. In the case of XML 
it could be the specification of DTD, etc. 


file footer The name of the The format should generate a common part that 
PFT to generate the | ends the output file, for example if the output 15 
file ending to be RTF, the format should generate closing 
parentheses. Also in the case of XML it should 
close the started parentheses 





Example 5 
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In this example we show a link downloading one record (with a given MEN) in the RTF 
format (taken from the LOAN system 


http://intradev.ifadhq.org:100/cgi-bin/isis3w.exe? 
search type-export mfn submit&export pftZERCONF&database-LOAN 
&export mfn from2000493&export mfn to2000493&export type-pft&lang-eln&export ext-rtf 


7.2. Data entry subsystem 


Now let us present the parameters for running the data entry functions. The basic 
parameters are shown in Table 7.3 


Table 7.3 Data entry and update parameters 


search type- Indicates the type of operation: 


Ef new | Provides new data entry form; requires 
specifying the parameter 
de worksheet;if optionally the 
parameter de define defaults 
is set to 1, the data entry form is 
provided in order to define dynamic 
defaults 

Ef modify | Provides data entry form filled with the 
contents of a record indicated for update; 
requires specifying the parameters 
de worksheet and rec id 


ЕТ сору | Provides data entry form filled with the 
contents of a record indicated for 
COPYing; requires specifying the 
parameters de worksheet, rec id 
and optionally copy format. П 
copy format is not provided, the 
system takes full dump of the indicated 
record for copying. 


BE delete | Performs deletion of the indicated 
record; requires specifying the parameter 
теста 

Ef submit Performs saving of the record in the 


database; the record will be saved as new 
or updated, depending on the value of 
the parameter de function. 
Requires also specifying the parameter 
Loc: Ld: 


ef page next Requires also specifying the parameters 
de worksheet andde page 
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ef page prev Requires also specifying the parameters 
de worksheet andde page 


ef field add ne |Generates a worksheets with another 


W occurrence. Requires also specifying the 
parameters de worksheet and 
de page 

Database= project, cds, | Different databases can be handled by 





etc the interface, hence database name must 
be specified. 


de mail prt email If provided with ef copy, ef new and 
ef update it is used to generate 
parameters for sending e-mail. The e- 
mail is sent only if the new/updated 
record has been successfully submitted. 

language - see notes on files allocation. 

Rec id- Sinteger- The МЕМ of the record to be accessed 
for update 

de worksheet- |е.9.: monograph | provides the name of the current 
worksheet 

de page = e.g. subject It provides the name of the current page 
of the worksheet; (hidden) 

de function = |e.g. new or | Used with ef submit 

modify 

de mail pre Used if we plan to send an e-mail on 
successful update of a database, e.g. 
LOAN database or ORDERS 

<string> Worksheet magic number, used to 

identify the ^ worksheet version 
(hidden) 

Oc derine- -def D. If 1, the data entry form is used for 

aults — defining defaults; otherwise the form is 
used to enter NEW record. 
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8. 1515 database and ISIS related files 


First, let us note that not all ISIS files are equally important in preparing access to ISIS 
databases from Web. These unimportant files are FDT and DOS data entry/update 
worksheets. 


As mentioned in Introduction, from the point of view of the ISIS database the Field Select 
Table plays one of the most important roles in implementing a user friendly search 
interface. It should be synchronized with Query Definition Table by means of identifying 
record types, and assigning prefixes to the searchable fields as defined in the Table. 


Another ISIS files, which influence the overall application lookup very much, are the 
display formats. They not only present result data, but also play a crucial role in defining 
inter-connectivity between various types of data by generating links. 


8.1. FST 
It is important to synchronize the database FST with the files: 


Search Definition File, as described in Introduction (see page Blad! Nie zdefiniowano 
zakladki.), 


Browse Definition File, as described in Introduction (see page Blad! Nie zdefiniowano 
zakladki.), as well as for the needs of selection lists foreseen in data entry worksheets 
(see Table 5.1, page 37). 


Let us remind again how the CGI program creates a query from the query HTML form: 


Rule 1 


For each search line every term in the line 1s preceded by the prefix indicated in the 
Search Definition Table for the given record type. If, for example, the Search definition 
file has a form 


[ana; ANA; Serials] 

“Keywords rom ibe hey “keywords TITLET; tha tye UM" y 

"lhdgirvrdugal Author", "aüthor', "уде етн s 

"Keywords trom Corporate Author", "corporate author", "Сда у 
CEeVWOEUS Trom- секта cle, “keywords, Seria! LILLE; орт рр 


Descriptors y "dosocrirpboss", DH") TLI. уе 


and in the search terms box for descriptors are the terms as shown below: 


Physics;optics;mechanics 
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Keywords from title: 
then the actual search terms used in the query are 
TI-physics 


TI-optics 


TI2Smechanics 


Rule 2 


For the record type as indicated in the database.def, the final query 15 ANDed by the term 
l-type. 


If a query has the form 
query; * query2*...* query; 


the CGI program transforms it to the form the 


(query; * query2*...* query;)* T-type 


So, if a query is formulated as below: 


ones: irom ee PRYVSLCS, ODL ICS; mechan ues 


AND 


Smith;Brown 
Individual Author : 


the CGI program will submit the query: 


(TI-physics +TI=optics +TI=mechanics) * (I[A=Smith+IA=Brown) * T=ANA 
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Let us assume that the sample database has an FDT the same as the CDS database, as 
supplied with ISIS: 


Conference main entry npdz [2 x00. U: 70 
Title 2 24 500 00 
EGltiorn 25 10:0: 10.10 
Imprint abc 2.0. I> Qr 20 
Collation abc оз. OD OO 
Series VZ 44 300 0 1 
Notes 50--500* Q 20 
Keywords 69 L000) О: 0 
Personal Authors JO. X00 


Corporate Bodies Tee BOW 
Meetings npdz EZ. BOO 
Added Title 2 74 500 
Other language titles Z 76-500 


Ss CF dex ues» O 
PRP PRP н 


So, for the table containing ANA record types as above, the following FST should be 
prepared: 


1 0 'T-ANA' 


70 0 МНО, (| IA2|V70/) 
QU ue pue x 

69 6 '/D-/'V69 

ZO. e pesto s eec 
ПВ л WIN dq 
44 8 '/ST-/' V44+|; | 


The sample CDS database considered here does not contain specific record types, 
therefore we generate the term T=ANA for each CDS record. In most applications, a 
special field may be foreseen in order to distinguish record types. If not, one can also 
distinguish record types by presence (or absence) of some fields specific for the given 
type ( e.g. “Analytic title" may appear only in the “paper” type records). 


8. 2. Record display formats 


For each record type specified in the definition tables one can prepare a number of 
formats (PFT files). The format names are provided in the definition table in the form of a 
choice list. The Format Choice list is not obligatory. If no Format choice list is defined, 
the system requests for some formats by default. The default format is provided in the 
config file 


15 It is the listing of the CDS.FDT from the DOS level 
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Note that for the maintenance purposes it is useful to name the formats in such a way that 
one can quickly recognize which format does what. 


Note: The Unix ISIS requires that all the format names have to be in upper case only. 


The display formats have to be prepared as normal ISIS formats. One can use all ISIS 
formatting features in order to generate an HTML portion from the displayed record. 
Usually the short display is designed in the way that only a basic data element 1s 
displayed. For example in the case of bibliographic database one can display title 
followed by author. This display should also have a link to make possible displaying of a 
given record in full format. 


The format may generate the following types of links: 


e search type-link - in this case one can refer to a given record (by MEN). In this 
case MEN of the current record may be taken, if one wants to show full record 
(this is a standard solution for changing from a brief format to a more 
comprehensive format; MEN may be also evaluated by REF (direct link) or 
REFTRM (back link - with the use of inverted file); 


e search type-query - in this case a value of a field or a number of fields can be 
used to build a query directed to the same or another database. Such a link 
refers to the CGI program with a query, and the end-user receives an answer for 
that query; 


e search type-browse - this can be used when a record provides a prefix which 
serves as a browse prefix. This technique is used in moving from one 
systematic level to another one while browsing a thesaurus. 


e search type-add thes word - this link can be used if we are going to 
implement a thesaurud based search. The link is usually, provided with a 
button, which if pressed, causes adding a given word to a cumulative list of 
descriptors. 


Exanple 1 (search type-link) 
Let us consider a short formats for the INFOTERRA database. 


"<B> [72 05) "—"V2*5 4) 8-gox9n] </B>"/, 
уой %, 


"<A 
HREF-"/cgi-bin/unep?rec id-',mfn,'&database-unep&search type-link&table-sources& 
back path-/unep/sources&lang-eng&format name-QERSRC"»', 


Mu T use ADT EHR! 
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As one can see the format displays only V2 (Identification number), V20 (Country) and 
V100 (Institution name), preceded by the unconditional literal being the link to the same 
record (search type-link) but with display format ERSRC (which displays more data 
from the record). 


Example 2 (search. type-query) 


Below is an example of a format for an ISIS database. In this format a dynamic link is 
provided for the Project Author field. The link generates a query for other projects 
authored by given researcher. The query will be submitted after clicking on the author 
name in the display. The query will eventually find other projects by the given author. In 
order to design a link of query type we have to refer to the structure of the FST. In the 
example below, we know that for querying projects by a given author we have to build a 
query R=name. The bolded part of the format shows the way we do it: 


1. by the ref function we get the Author record linked to the Project record; 


2. in the author record we take the name (and surname) of expert (fields v501, v231) and 
prefix it by the prefix appropriate for querying projects by authors. 


"<B> то реу Ba m, 

"<А HREF="/cgi-bin/sibrol?query=', 

if p(V640)then ref(1(V640) ,if p(V501)then 'R-',&norm(V501," "V231) fi)else "R=", 
&norm(V641.28) fi, 

'&database=SIB&search type=query&table=projects&back path=/sibrol/projects&lang= 
eng&format name=@ERPRO">', 

if p(V640) then ref(1(V640),if p(V501)then V501," "V231 fi)else V641 fi,'</A>', 
if (p(V640)or p(v641))and (p(V650)or p(V651)or p(V660)or p(V661)) then ' & oth. 

P oou 

if p(V640)or p(v641)or p(V650)or p(V651)or p(V660)or p(V661) then ': ' fi, 

"<А HREF="/cgi-bin/sibrol?rec id=',mfn, 'édatabase=SIB&search type-link&table-pro 
jects&back path-/sibrol/projects&lang-eng&format name=@ERPRO">', 

VELT, 

ау 7) them б Ет, 

е 

if p(V610) then ref(l(Vol0),(if p(V204) or p(V206) then, 

'<BR>!, 

"<А HREF="/cgi-bin/sibrol?query=',if p(V204) then 'EX:', &norm(V204.27) else 'EX: 
',&norm(V206.27)fi, 

'&database=SIB&search type=query&table=projects&back path=/sibrol/projects&lang= 
eng&format name=@ESPRO">', 


М Оба SIRT Er) 
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Notes: 


(1) The ISIS PFT requests for new line (slash) do not cause a new line in the HTML 
output. To force the display to the new line one has to start a new paragraph. The ISIS 
new lines serve only a better visualization of the HTML output for testing purposes. 


(2) The parameters for the link should be provided according to the rules specified in the 
table defining CGI interface. 


(3) In the type of link search. type-query the record field may contain characters which 
are illegal for the Web links. In the LINUX WWW-ISIS system a special format exit 
prepared &norm, which standardize the link form, according to the http rules (it 
replaces nonstandard characters to the acceptable form e.g. space to *%20” 

(4) In case of the Windows version the format exits are not allowed. Therefore the CGI 


program automatically resolves all illegal characters within the links generated by the 
format 


In the next example we illustrate the “browse” links and the add term links. 


Example 3 (browse and add term type link) 


. if v989*2='000' then, 
ОЗО ЖЕ сс» UT. 
. '<А HREF = "/cgi-bin/envoc?search type-add thes word&thes word-', 


. V001, '&lang=eng" TARGET-"thes words"> 


1 
2 
3 
4 
5. <IMG SRC="/envoc/imgs/plus.gif" WIDTH-9 HEIGHT=9 
6. BORDER=0></A>é&nbsp; &nbsp;', 

7. '<A HREF = 

8. "/cgi-bin/envoc?search type-browse&database-THES&thesaurus-yes&prefix-L2:', 
9. v989.2,'&format name-QEL2&start term-&lang-eng&page header=@EP2">', 
10.mpu,V001,'«/A»',' '«BR»'/, 


Iq 


In the format above the link in the lines 3-6 1s of the add. term type. We can see here that 
a special icon is provided to visualize the link. The link is dynamic - the word to be 
“picked up" is taken from the ISIS record's field V1. As a target for the selected words a 
special frame has to be prepared (here it is under the name thes words). 


'* Only Linux 
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The lines 7-10 provide another dynamic link - this link 1s for performing "browse with the 
prefix defined by the literal L2: and the contents of the field v989 (only the first two 
characters are taken). 


8.3. Windows NT formatting tools 


Due to the fact that ISIS-DLL does not support Pascal exits in the formats, the formats 
using such exits have to be rewritten. The main features that were programmed by Pascal 
exits are now included to the main program or are resolved by better ISIS-DLL 
functionality: 


e ‘Translation of special characters in HREF (done by CGI) 


e Resolving the final address of the full text document - a path part can be defined in 
CFG (e.g. during the system installation and then controlled by CGI) 


e "paging" of too long displays of descriptors is not needed anymore, (larger format 
outputs are allowed by ISIS-DLL) 


Format "exits" 


As there is no possibility to use the pascal exits, it was necessary to devote some 
"dummy" fields to the parameters useful for formatting headings, links to source 
documents, etc. 


Below are listed the tags of dummy fields 


9980 - root term in browse list 

9982 - document location prefix 

9984 - names of databases used in search 
9991 - requested number of results 

9999 - returned number of results 


The tags can be used in the formatting language for browsing, defining a page header, etc. 


REF functionality 


The existing ISIS-DLL version does support properly the formatting functions REF and 
LREF. In adition, in order to support “back compatibility as well as “remote refs, a 
"recursive" solution from the old WWW:-ISIS has been preserved. It consists in 
generating in the format the ISISREF link. In order to generate a link the ISIS format has 
to produce one of the following structures: 


1. <ISISREF DBN= databasename, MFN=nnn; PFT=@formatname; [max loop2nn], [max record- nn] 
> 


2. <ISISREF DBN= databasename; L-access point; PFT=@formatname; SORT PFT-2Gformatname 
[max loopznn], [max record- nn]> 
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In the first case the link indicates another record by MEN, whereas in the second case, one 
or more records are indicated by the lookup function L referring to the inverted file, where 
the postings are taken from. 





Example 1 
<ISISREF DBN= CDS; MFN=120; PFT=@CDS> 


In this case the WWW-ISIS program will try to open the record with MFN=120 and apply 
on it the format CDS. 


Example 2 
<ISISREF DBN= FAOLEX; L=PD=LEX-000011; PFT=@title> 


In this case the program will refer to the access point PDZLEX-00001 1, and will format 
the indicated record by the format @ title. 


More precisely, if the cgi program finds such a link it performs the following procedure: 
1. extracts the link from the formatted area 
2. selects the "linking parameters", and according to them generates appropriate text; 


3. if the text does not contain any other link, inserts the text to the place where the link 
was extracted. If a link was found in the generated text the procedure repeats. 


If the link is indicated by the lookup function, there may be more than one record linked. 
In this case the format indicated by the PFT parameter is applied on all records and the 
text 1s incorporated to the output area. 


Remote ISISREF 


In addition to the local ISISREF (which btw, is not anymore needed with the new a-ISIS), 
there is an option of using ISISREF for accessing remote databases. The general syntax is 
the same as the old ISISREF's syntax. The only difference is that the DBN.DEF should 
define the location (URL) of the remote database: 


«logical name of remote DB>; «URL of DB»; «remote flag>; [<real name>] 
where 


- «remote flag can have the value 1 (remote access), or О (local access) 
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- the parameter in [...] 1s optional); 


- real name may differ from logical name, so that one can refer to a database having 


the same name as the local database 


For example the line below in dnb.def: 


Legal; http://fiucn.cus.de/cgi-bin/isis3w.exe ; 1; 


will make possible accessing the ISIS database legal by ISISREF under the indicated 
URL. (if the remote name is the same as one of the local databases we can assign the 
logical name different from the real one. 


8.4. Other types of formats 


A number of additional formats can be defined in order to improve a general look of the 
system: 


1. For each record type one can define "page header format" which may provide 
additional information on the result page; 


2. Each record can be preceded by a *record header" 


When ISIS formats the answer, a dummy format is created which contains valuable data, 
which can be displayed in the result page as a header: 


e V9990 provides a number of hits; 
e V9998 stores the sequential position of the current record within the given answer 
e V999] provides a number of records presented 


e V9990 provides the current record format name 


Below 15 an example of the page header format for the FAODOC database: 


'<CENTER><H4>', 
if val(V9999) > val(V9991) then, 
V9999" record(s) found - ",V9991" record(s) presented (too general query)", 
"<BR> «A HREF="../faodoc/help/examples.html">See examples</A>' 
else, 
if val (V9999) > 0 then, 
V9999" record(s) found", 
else, 
"Тоо restrictive query, ','<A HREF-"../faodoc/help/examples.html"»see 
examples</A>', 
fi, 
fi; 
'</H4></CENTER> <HR>', 


If needed, in the record header format one could use the field V9998, which stores the 
sequential number of record in the answer. 
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9. How to implement Thesaurus based search 


9. ]. Thesaurus structure 
The thesaurus database should be structured according to the following rules: 


1. One record should contain all information dealing with the “term article", 1.e. main 
term, classification codes, and all related terms (BT, NT, RT, US, UF, ...); 


2. For each relation type there should be a unique field tag assigned 
3. Each relation 1s implemented as a repeatable field 


4. АП the fields linking to other term records by a given relation should be ordered 
alphabetically within the given record. 


We assume below that the thesaurus structure is compatible with the MTMA software, 
although other similar solutions are also acceptable (e.g. a structure of MTM3). The most 
important part of the thesaurus FDT is as follows: 








Descriptor l-st lead. lang. 13000 
Scope note 2 500 0 1 
US l-st lead. lang. S: SOLD B 

UF l-st lead. lang. 4 30 0 1 

BT 5 OU IDE 

NT 6 30 0 1 

RT -30-0 T 
Non-descriptor 8 30 0 0 
OTHER l-st lead. lang. 9 30 0 0 
Stopwords l-st lead. lang. 10 1650 01 
+US l-st lead. lang. pd. 02D 3E 
+UF Теве lead. lang. T2 300-1 
Hash flag 19 30 0 1 
Top classification name 20 30 0 1 
Descriptor 2-nd add. lang. 101 30 0 0 
Scope note 102 500 0 0 
US 2-па add. lang. 103 30 0 0 
UF 2-nd add. lang. 104 30 0 0 
BT 105 30 0 0 
NT 106 30 0 0 
RT 107 30 0 0 
Non-descriptor 108 30 0 0 
OTHER 2-nd add. lang. 109 30 0 0 
Stopwords 2-nd add. lang. 110 1650 01 
+US 2-nd add. lang. 111 30 0 1 
+UF 2-nd add. lang. 112 30 01 
TERM ТҮРЕ (ТЗЕ?С): 975 100 
Classification code (facet) 989 100 01 
Remarks 990730020: -T 
Secondary Category Codes 993-300 OI 
Concept Number 994 600 
Concordance Relation (CR) td 995 60 0 1 
GENERAL NOTE (in one language) 996 300 00 
Stamp date for relation 997 18 О 0 
Stamp date for term 998 18 О 0 
Top classification (terms) 999 100 0 1 
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The main question now is how can we organize the navigation through the thesaurus. 


For this FDT we can design the following navigation styles: 


e alphabetic 
e KWOC 
e systematic. 


АП these navigation ways can be implemented by means of the "browse" function. To this 
end we have to plan accessing the thesaurus terms by 


e "main term" as it is (for the alphabetic order) 
e each keyword in the term (for KWOC) 


e classification code 


So the basic FST lines for the alphabetic navigation can be done as below: 


p uU MES Tyd 
O D. METUS 


Note that we want to see not only descriptors but also non-descriptors (v8). 


The FST lines for the KWOC browsing should index terms by each word, so the FST 
technique 8 should be applied: 


Q3. TIE Ww 
Soo TESS yN 


For the systematic browse we prepare the first level classification index. If the coding 
system preserves the hierarchical structure of the thesaurus, we can also index the next 
levels, although in this case the prefix has to be created dynamically. Below the 
generation of dynamic prefixes is shown for the INFOTERRA thesaurus (lines 2 and 3) 


989-0.. (CITT: (Y98977 
989 Юа VISS 00р" then IEL Г УЛО ОС) 
989: 0: Ait VISI с нн = Д2 VIET) 
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9.2. Definition table 


The Browse Definition File has to be defined according to the prefixes specified in the 
THES.FST file. An example of the Browse Definition Table is given below. 


descriptors? DSA, EnVoc. Terms] 

[prefix; E:*@EA1; alphabetic] 

[ргеЁ1х; 11:*@Е11; systematic] 

[prefix; ES:*@EK1; KWOC] 

# one format specification needed to define format variable on the HTML pages 
[format; @ЕА1; alphabetic] 


ou um cu i "=н 


# Bindings definitions 


«brnding', "brndr",:"unep", “Sources "у “environmental descriptors” 





9.3. HTML frames 


The solution described here is not an obligatory solution, although we recommend that the 
thesaurus navigation screen consists of the following three frames: 


e the left frame with the menu-like table of contents for the functions of the system - the 
same layout as standard search and answer screens; 


e the central frame for the thesaurus navigation 


e the right frame called thes words (see the display format from Example 3, p. 92) 


Such a layout ensures that the user immediately sees what has been added to the 
cummulated list and what else has to be added. 


The frame thes words is created automatically by the system using the HTP predefined 
form thes.htp. 


9. 4. Binding thesaurus to a given database 
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Binding is a mechanism that 1s used to provide proper functionality of a "clipboard" 
where the selected terms are stored. In order to fill normal Search Form dynamically with 
the "clipboard" terms, the CGI program has to know a database name, table name and 
field name. Because it would be very redundant to provide this information in each 
add term link, only a binding name is provided in the link. The specific binding 
information under this name is contained in the search definition specification. Binding is 
a set of information: binding name, database name, table name, 
гео name: 


If binding name is not provided in a given link, the default binding is used. The 
default binding is declared by DefaultBinding parameter (see Section 3. , page 13). 


Example: 


In the Browse definition file we have: 


^orndxng'",y "*AGRIS-termsl", "agris", "МОМ". "AGROVOC: /kevwords" 


"binding", "AGRIS-termsz" , "agris", "ANA", 'AGROVOC keywords" 


whereas in the configuration file the parameter DefaultBinding is setup to AGRIS- 
termsl. 


For this case, if no binding is defined in the add. term link, the system will use the binding 
AGRIS-terms1, as declared in the configuration file. 


100 


WWWIISIS - Technical Reference Manual 


10. Building your own system 


10. 1. Ten steps to build the system - a summary 


АП the necessary information needed to create a WWW interface to your database was 
presented in this manual, a short summary follows below: 


. Start with the provided version, install and test it. 


. Make a workable copy of the version, use it from now on (you can always use the 


workable demo as reference) 


3. Make a copy of the cgi binary, its new name will be the name of your new project. 


. copy a parameter (cfg) file in cgi-bin (the same name as cgi, with the extension *.cfg. 


5. Modify HTML files to suit your system. Take special caution when modifying the 


7. 
8. 
9. 


Index.html and toc.html, providing there proper names of the database and cgi program 
in the cgi scripts. 


. Modify HTP files (read the section on HTP carefully). At the start make only the 


minimal necessary changes in cgi-bin links 
Create РЕТ (1515 format files). 
Check that directories configured in cgi-bin/project.cfg are correct. 


Test your new system. 


10.Fine tune HTML and HTP files. 


For the points 4-10 above see p. 10. 3 below. 


10. 2. Instalation and setup of a demo version" 


15 


Unpack the file wwwisisdemo-distrib-linux-32.tgz 


oe 


gzip -d wwwisisdemo-distrib-linux-32.tgz 


Locate your Web servers document directory. It can be something like: 
/usr/local/httpd/htdocs If you are not sure, contact your web server 
administrator. 


The section refers to Linux only. For the Windows NT a specialized installation 


procedure has been prepared. 
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e Unpack the distribution to the web server's document directory: 
$ cd — your web serv doc dir 


$ tar xvpf wwwisisdemo-32-linux.tar 


Note 1: you must have a write access permission to the top-level directory to do this. 


Note 2: it is critical to use the p tar flag. 


e Locate your web server's cgi-bin directory. Copy files: demoisis and 
demoisis.cfg to the cgi-bin directory. 


e The WWNWIISIS 1S preconfigured to be installed in 
/usr/local/httpd/htdocs/ directory. If you have installed it 
somewhere else, you must edit the configuration files: 


edit demoisis.cfg file: change /usr/local/httpd/htdocs/ path in all parameters 
to your web server's document directory. 


edit..../demoisis/db/ig file 


locate the assignment: ISTSINSTDIR-... change it accordingly. 


e That's all! 


load http: //your-server/demoisis/ into your browser, and test the interface. 


10. 3. Modifications of the HTML/HTP Files 


The following rules should be applied when modifying or translating the system files of 
an existing application: 


e HTML documents should be translated to the target language and placed in the 
relevant directory (see lang.html). Absolute hypertext links should be 
changed to point to this directory. The HTML documents for different language 
versions should be placed in directories sharing a common parent directory 
(possibly the http server's directory "htdocs"). 
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АП the Cgi-bin links in the HTML pages should be preserved, with the 
exception of  lang-eng key-value рат Бепо translated to 
Lang-target language; 


АП the Cgi-bin links appearing in the /sis formats ?S*.PFT and ?R*.PFT 
should also be changed accordingly. 


The "target language" constant should be the name of the HTP files 
subdirectory. For example, for the target language English, if “fre” is chosen 
for the lang variable, the translated HTP documents should be found in the 
.../htp/fre/ directory. 


Special caution should be taken when translating the HTP documents: the 
number and ordering of lines should be preserved, token between, and after 
“@?” апа * 96" characters should not be changed. 


103 


WWWIISIS - Technical Reference Manual 


11. WWW Administration procedures 


In order to simplify the publication process special environments has to be prepared for 
the administration purposes. They can be available from the directory of the WWW 
master on Linux. One should install there a replica of the ISIS database and provide a 
script to run ISIS from this directory. Such a setup is useful for generating inverted file for 
a new database before publishing it. In addition, another script should be provided which 
copies the database from this directory to the WWW working database directory. 


Provided that such arrangements have been done, the following procedure has to be 
applied in order to publish a new version of the database: 


1. take a backup from the database stored before firewall (usually maintained in a LAN 
environment) 


2. Perform binary FTP of the backup to the directory of the Web Master 
Note: ISIS under UNIX requires that the name of the backup file is 1n upper case 


3. from the Web Master directory start the 1sis program 
4. from the ISIS menu for MASTER procedures run BACKUP Restore 


5. from the ISIS menu for Inverted file procedures run the option “Generate full inverted 
Ше”; 


exit from ISIS and return to the Linux prompt 


7. copy the new version of the database in ISIS form to the WWW environment (it 1s 
usually a script predefined that copies all ISIS database files to the WWW 
environment. 
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12. Solving problems 


The main page doesn't load. 


- You have installed the HTML pages in a directory that 15 not recognized by your WWW 
server. Consult the web server's documentation or your web server's administrator. 


The main page does load, but the interface doesn't run - an error message from the 
web server is displayed. 


- Have you copied the cgi program and *.cfg to the cgi-bin directory? Please note the both 
files should have the synchronized names 


- Is cgi-bin correctly configured on the web server? It can be deactivated or not properly 
configured. 


- Is cgi-bin called exactly 'cgi-bin' - try to run other cgi programs from your server: 
http://your-server/cgi-bin/... 


- Check web server's log files (typically —httpd/logs/1access|errors?) for other cgi-bin 
related problems. 


The cgi interface works, but no data is retrieved from the database, also strange 
messages are printed on top of the Web-pages. 


- This is probably caused by an error in configuration. files: check again 
cgi-bin/isis3w.cfg. 
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13. Final remarks 

As one can see the system can be easily customized to specific needs, and can be used to 
adjust changes to the search screens, whenever needed. Under one application it is 
possible to arrange access to an unlimited number of ISIS databases. 
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15. Annex 


15. 1. Sample HTP for the new WEBLIS application 


Search HTP 


7 187 190 191 9 

#0 

#1 «IDOCTYPE HTML PUBLIC "-/IETF/DTD HTML 3.0//EN">\ 
«HTML» 

<!-- Generic HTML v 3.0 20/02/1999 tra template v1.0 isis3w --> 


#2 <HEAD><META http-equiv2"Content- Type" content="text/html; charset=iso-8859-1"> 


#3 <TITLE>LIBCAT</TITLE> \ 
<link rel="stylesheet" type="text/css" href="/libcat/main.css"> 
#4 
#5 <!-- htp_include: makeurl.js --> 
#6 
#7 </HEAD> 
#8 <BODY > 
#9 


#10 «TABLE classz'header'» «TR» «TD class='maincolor'> 9es %s </TD></TR></TABLE> 


#11 

#12 

#13 

#14 

#15 

#16 «H3» «CENTER» 96s %S </CENTER> «/H3» 

#17 «H3» <CENTER> Registering Form </CENTER> </H3> 
#18 


#24 

#25 «HR» <H4> Current search string: 96s </Н4> </HR> 

#26 

#27 

#28 

#29 

#30 <FORM METHOD=POST ACTION-"/cgi-bin/isis3w.exe" \ 
ENCTYPE-"application/x-www/form-urlencoded" ^ 
NAME-"search form" V 
onSubmit="return submit form(this);"» 

#31 <INPUT TYPE="HIDDEN" NAME-"database" VALUE="@database@"> 

#32 <INPUT TYPE="HIDDEN" NAME="table" VALUE="@table@"> 

#33 <INPUT TYPE="HIDDEN" NAME="lang" VALUE="@lang@"> \ 
<INPUT TYPE="HIDDEN" NAME="page_header" VALUE="EPHMON">\ 
<INPUT TYPE="HIDDEN" NAME="sformat" VALUE="@sformat@">\ 
<INPUT TYPE="HIDDEN" NAME-"Iformat" VALUE="@lformat@">\ 
<INPUT TYPE="HIDDEN" NAME="sformat_rtf" VALUE="@sformat_rtf@">\ 
<INPUT TYPE="HIDDEN" NAME-"Iformat rtf" VALUE="@lformat_rtf@"> 

#34 

#35 

#36 <INPUT TYPE="HIDDEN" NAME-"search type" VALUE="%s">\ 
<INPUT TYPE="HIDDEN" NAME-"bookmark create" VALUE="0"> ^ 
<INPUT TYPE="HIDDEN" NAME="SEARCH" VALUE=""> 

#37 

#38 <INPUT TYPE="HIDDEN" NAME-"term" VALUE="%s"> 

#39 <INPUT TYPE="HIDDEN" NAME="first" VALUE="%s"> 

#40 <INPUT TYPE="HIDDEN" NAME="last" VALUE="%s"> 

#41 <INPUT TYPE="HIDDEN" NAME-"original" VALUE="%s"> 

#42 

#43 

#44 

#45 <INPUT TYPE="HIDDEN" NAME="%s" VALUE="%s"> 

#46 

#47 
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#48 
#49 
#50 <TABLE border='0' COLS=3 WIDTH="85%" COLLSPACING=0 PADDING=0> \ 
<TR> \ 
«TD class='help'> ^ 
Exact match of words: \ 
<INPUT TYPE="CHECKBOX" NAME-"wildcard" VALUE="wildcard" CHECKED»«/TD» \ 
«TD ALIGN-RIGHT2 «SMALL» V 
<INPUT NAME="SEARCH BUTTON" TYPE="SUBMIT" VALUE="SEARCH" class="formbutton" TITLE="Submit 
defined query" 
onClick="window.document.search_form.bookmark_create.value='0';window.document.search_form.target=";button_clicke 
d(this);">&nbsp;\ 
<INPUT TYPE=BUTTON NAME-"ADD BOOKMARK" VALUE="SAVE" class="formbutton" 
onClick="window.document.search_form.bookmark_create.value='1';window.document.search_form.target='bookmark';wi 
ndow.open(makeurl('/cgi- 
bin/isisSw.exe?search_type=view_query_current'),'View_Query','width=610,height=500,location=no,status=no,toolbar=yes, 
menubar=yes,scrollbars=yes,resizable=yes')">&nbsp;\ 
<INPUT NAME="VIEW_QUERY" TYPE="BUTTON" VALUE="ISIS QL" class="formbutton" TITLE="Edit defined query" 
onClick="window.document.search_form.bookmark_create.value='0';window.document.search_form.target=";window.open 
(makeurl('/cgi- 
bin/isisSw.exe?search_type=view_query_current'),'View_Query','width=610,height=500,toolbar=yes, location=no,status=no, 
menubar=no,scrollbars=yes,resizable=yes')"> 
#51 <INPUT NAME="CLEAR" TYPE="RESET" VALUE="UNDO" class-"formbutton" TITLE="Clear last input" 
onClick="window.document.search_form.bookmark_create.value='0';window.document.search_form.target=";"> ^ 
<INPUT NAME="CLEAR" TYPE="BUTTON" VALUE="CLEAR" class-"formbutton" TITLE="Clear the form" 
onClick="window.document.search_form.bookmark_create.value='0';window.document.search_form.target="; 
submit_again()"> \ 
</TD></TR> 
#52 </TABLE> 
#53 «Table BORDER='0' WIDTH='600'> 
; Table for databases selection (in multi-base search) or Index selection 
#54 
#54 <TD WIDTH="180"><INPUT TYPE="checkbox" NAME-"wildcard" VALUE="wildcard"></T D> 
#55 «TD COLSPAN=2> Use UNDO to clear last input; use CLEAR to clear the form </TD></TR> </TABLE> <TABLE> 
#55 <table border='0' width="800">\ 
; table for search mask when single-base search 
#56 
#57 
#58 </TD></TR> 
#59 
#60 <TR class='maincolor'> ^ 
«TD class="help'> %s </TD> \ 
«TD NOWRAP colspan='2'> V 
<INPUT TYPE="TEXT" NAME="%s" class ="formbox" SIZE=45 MAXLENGTH=150 VALUE="%s"> 
#61 <INPUT TYPE="SUBMIT" NAME="%s%s" VALUE="List" class-"formbutton" V 


onClick="window.document.search_form.bookmark_create.value='0';window.document.search_form.target=";button_clicke 
d(this);"> 
; AND as default between terms 
; OR as default between terms 
#62 «SELECT NAME="%s%s" class="selbox" SIZE=1><OPTION %s VALUE="AND"> AND «OPTION %s VALUE="OR"> 
OR </SELECT> 
#63 <TR><TD class="maincolor"> «SMALL» %s </SMALL></TD> <TD> <B><SMALL><SELECT MULTIPLE NAME="%s" 
SIZE=3> 
#64 <OPTION>%s 
#65 </SELECT></TD> 
#66 
#67 <TR><TD CLASS="maincolor"><B><SMALL> %s</TD> <TD><SELECT MULTIPLE NAME="%s"> 
468 </SELECT></TD></TR> 
#68 </SELECT> 
; eof selection for sort/format 
#69 
#70 <TD><INPUT TYPE="SUBMIT" NAME="ada" classz"formbutton" VALUE="Select" TITLE="Send selected terms to the 
form" \ 
onClick="button_clicked(this)"></TD> 
#71 <TD><INPUT TYPE="SUBMIT" NAME="more" class="formbutton" VALUE="PgDn" TITLE="Move to next page of the 
dictionary" \ 
onClick="button_clicked(this)"></TD> 
#72 <TD><INPUT TYPE="SUBMIT" NAME="back" class="formbutton" VALUE="Home" TITLE="Move to the first page of 
the dictionary” \ 
onClick="button_clicked(this)"></TD> 
#73 <TD><INPUT TYPE="SUBMIT" NAME="cancel" class="formbutton" VALUE="Go back" TITLE="Go back to the search 
form" \ 
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onClick="button_clicked(this)"></TD> 
#70 <TD><INPUT TYPE="SUBMIT" NAME="add" VALUE="Select" TITLE="Send selected terms to the form"></TD> 
#71 <TD><INPUT TYPE="SUBMIT" NAME="more" VALUE="PgDn" TITLE="Move to next page of the dictionary"></TD> 
#72 <TD><INPUT TYPE="SUBMIT" NAME="back" VALUE-"Home" TITLE="Move to the first page of the 
dictionary"></TD> 
#73 <TD><INPUT TYPE="SUBMIT" NAME="cancel" VALUE="Go back" TITLE="Go back to the search form"></TD> 
#74 
#75 
#76 «TR CLASS='maincolor'> ^ 
«TD class="help'>%s</TD> ^ 
«TD NOWRAP colspan='2' class-'help'» &nbsp;%s&nbsp; \ 
<INPUT TYPE="TEXT" NAME="%s_from" SIZE=%d class ="shortbox" MAXLENGTH=150 VALUE="%s"> ^ 
&nbsp; &nbsp; &nbsp;%s&nbsp; \ 
<INPUT TYPE="TEXT" NAME="%s_to" SIZE=%d MAXLENGTH=150 class ="shortbox" VALUE="%s">\ 
</TD></TR><TR> «TD colspan='3'><HR><BR></TD> </TR> 
#77 «TR CLASS="maincolor'><TD><B><SMALL> %s </SMALL></B></TD><TD NOWRAP» 
<B><SMALL>&nbsp;%s&nbsp;</SMALL></B><INPUT TYPE="TEXT" NAME="%s_ eq" SIZE=%d class ="formbox" 
MAXLENGTH=150 VALUE="%s">\ 
</TD></TR> 
#78 «TR CLASS="maincolor'><TD> %s </TD>\ 
«TD NOWRAP» 
«B» 96s </B><INPUT TYPE="TEXT" NAME="%s" SIZE=%d class ="formbox" MAXLENGTH=150 VALUE="%s">\ 
</TD><TD>&nbsp;</TD></TR> 
#79 
#80 </TR> 
#81 
#82 
#83 
#84 
#85 <TR><TD>&nbsp;</TD><TD NOWRAP><INPUT TYPE="RADIO" NAME="%s%s" VALUE="AND" %s > AND <INPUT 
TYPE="RADIO" NAME="%s%s" VALUE="OR" %s> OR <INPUT TYPE="RADIO" NAME="%s%s" VALUE="NOT" 96s > 
NOT </TD><TD>&nbsp;</TD></TR> 
#86 


#89 <TR><TD NOWRAP COLSPAN='3'><HR></TD></TR> 

; HR above search mask 

#90 <TR><TD> %s </TD><TD><SELECT NAME="%s" class="selbox" SIZE=1> 

#91 «OPTION %s VALUE="%s"> %s 

#92 

#93 

#94 

#95 <TR><TD ALIGN=RIGHT>Sort: </TD><TD NOWRAP COLSPAN='3'><SELECT NAME="%s" class="selbox" SIZE=1> 
#96 &nbsp; &nbsp; &nbsp; &nbsp; Format: «SELECT NAME="%s" class="selbox" SIZE=1> 

#97 

#98 

#99 

‚ННН ENTRY 

#100 <TR><TD> 96s </TD><TD NOWRAPs<INPUT TYPE="TEXT" NAME="%s" SIZE=%d МАХГЕМОТН=%а 
VALUE="%s"> 

#101 <TR><TD> %s </TD><TD NOWRAP»«TEXTAREA NAME="%s" ROWS=%d COLS=%d MAXLENGTH=%d 
VALUE="%s" WRAP>%s</TEXTAREA> 

#102 

#103 

#104 

#105 

#106 

#107 

#108 

#109 

; ННН NEW SELECTS 

#110 «TR CLASS="maincolor'><TD class='help'>%s</TD><TD colspan='2'><SELECT MULTIPLE NAME="%s" SIZE=%d> 
#111 «TR CLASS='maincolor'><TD class='help'>%s</TD><TD colspan='2'><SELECT NAME="%s" SIZE=%d> 

#112 

#113 «OPTION %s VALUE="%s">%s 

#114 

#115 </SELECT>&nbsp;</TD></TR> 

#116 

#117 

#118 

#119 

; #HHHH LIST WITH CHECKBOXES 

#120 <TR CLASS='maincolor'><TD COLSPAN='2'> %s </TD></TR> \ 
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<TR><TD COLSPAN='3'><span class='maincolor'>Currently — selected term(s): «B»96s«/B»&nbsp; 
</span></TD></TR> 
#121 <INPUT NAME-'s %s" TYPE="SUBMIT" class-"formbutton" VALUE-"GO TO" onClick="button_clicked(this); 
window.document.search_form.search_type.value='dynamic';"></TD><TD>&nbsp;</TD> ^ 
«TR» «TD NOWRAP» 
<INPUT TYPE="SUBMIT" NAME-"add" class="formbutton" VALUE-"Select" onClick="button_clicked(this)">\ 
<INPUT TYPE="SUBMIT" NAME="more" class="formbutton" VALUE="PgDn" onClick="button_clicked(this)">\ 
<INPUT TYPE="SUBMIT" NAME="back" class="formbutton" VALUE="PgUp" onClick="button_clicked(this)"></TD> \ 
<TD> \ 
<INPUT TYPE="SUBMIT" class="formbutton" NAME="cancel" VALUE="Go back" onClick="button_clicked(this)"> ^ 
<INPUT TYPE="BUTTON"  class="formbutton" NAME="cancel" class-"formbutton" VALUE="Clear раде" 
onClick="clear_page(this.form)"> \ 


<INPUT TYPE="BUTTON"  class="formbutton" NAME="cancel"  class-"formbutton" VALUE="Clear all" 
onClick-"clear all items(document, this.form, '%s')"> ^ 
</TD></TR> 


#122 «TR ><TD WIDTH="1%%"> ^ 
<INPUT TYPE="CHECKBOX" NAME="%s" VALUE="%s" %sS></TD> \ 
«TD WIDTH="200" NOWRAP CLASS="LISTITEM">%s</TD><TD WIDTH="100%%"> %d </TD></TR> 
#123 <INPUT TYPE="HIDDEN" NAME="%s" VALUE="@%s@"> 
#124 <INPUT TYPE="HIDDEN" NAME-"goto flag" VALUE="1"> 
#125 <TR><TD NOWRAP><INPUT TYPE="TEXT" class="selbox" NAME="goto" SIZE=25 MAXLENGTH=100 VALUES=""> 
#126 
#127 
#128 
#129 <TABLE Width = 50%><TR><TD COLSPAN=3>Database selection for <B>%S</B></TD><TR> 
#130 <TR> 
#131 <TD Align="right">Search In: &nbsp;</TD> 
#132 «TD COLSPAN=3> 
#133 <B>%S</B><INPUT TYPE="CHECKBOX" NAME="database" VALUE="%s" %s OnClick="cb_click(this)"> &nbsp; 
#134 <B>%S</B><INPUT TYPE="CHECKBOX" NAME="db_select_database" VALUE="%s" %s OnClick="cb_click(this)"> 
&nbsp; 
#135 </TD> 
#136 </TR> 
#137 <TR><TD COLSPAN=3 ALIGN=CENTER><SMALL><INPUT NAME="SAVE" TYPE="SUBMIT" VALUE="SAVE" 
TITLE="Save database selection"></TD></TR></TABLE> 
‘#129 
#130 <TR> 
#131 «TD»Search In:</TD> 
#132 <TD COLSPAN=2> 
#133 <B>%S</B><INPUT TYPE="CHECKBOX" NAME-"database" VALUE="%s" 9es OnClick="cb_click(this)"> &nbsp; 
#134 <B>%s [ON]</B> &nbsp; 
“#134 <B>%s</B><INPUT TYPE="CHECKBOX" NAME="database" VALUE="%s" $ CHECKED 
OnClick="cb_click(this)"> &nbsp; 
#135 </TD> 
#136 </TR><TR>&nbsp;</TR> 
#137 
#138 <P>Database selection saved 
#139 
#140 <TR><TD class='maincolor'> %s </TD> 
#141 «TD class='maincolor'> 
#142 <TABLE BORDER=0 WIDTH="100%" Padding=0> 
#143 <TR> 
#144 <TD><INPUT TYPE="checkbox" NAME="%s" VALUE="%s" %s> %S</TD> 
#145 </TABLE></TD></TR> 
#146 </TR> 
#147 
#148 
#149 
#150 <TD><INPUT TYPE="RADIO" NAME="%s" VALUE="%s" 96s > %S</TD> 
#151 
#152 <TR><TD class='maincolor'><B><SMALL><SELECT NAME="%s%s" class="selbox" SIZE=1> 
#153 «OPTION 96s VALUE="%d">%s 
#154 </SELECT></SMALL></B></TD> 
#155 <TD classz'maincolor NOWRAP><INPUT TYPE="TEXT" NAME="%s" class="formbox" SIZE=45 MAXLENGTH=150 
VALUE="%s"> 
#156 
31157 </TABLE> 
‘#158 
3:159 
3:160 </FORM> 
31157 </TABLE><HR> 
#157 «/TABLE» 
#158 «SCRIPT Language-"JavaScript'» hide opers(); </SCRIPT> «BR» 
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<TABLE WIDTH="85%" COLLSPACING=0 PADDING=0><TR><TD ALIGN="RIGHT"><SMALL>\ 
<INPUT NAME="SEARCH_BUTTON" TYPE="SUBMIT" VALUE="SEARCH" class-"formbutton" TITLE="Submit defined 
query" 
onClick="window.document.search_form.bookmark_create.value='0';window.document.search_form.target=";button_clicke 
d(this);">&nbsp;\ 
<INPUT TYPE=BUTTON NAME-"ADD BOOKMARK" VALUE="SAVE" class="formbutton" 
onClick="window.document.search_form.bookmark_create.value='1';window.document.search_form.target='bookmark';wi 
ndow.open(makeurl('/cgi- 
bin/isis3w.exe?search type-view query current), View Query','width2610,height-500,location2no,status-no,toolbarzyes, 
menubar=yes,scrollbars=yes,resizable=yes')">&nbsp;\ 
<INPUT NAME="VIEW_QUERY" TYPE="BUTTON" VALUE="ISIS QL" class-"formbutton" TITLE="Edit defined query" 
onClick="window.document.search_form.bookmark_create.value='0';window.document.search_form.target=";window.open 
(makeurl("/cgi- 
bin/isis3w.exe?search type-view query current"), View Query','width2610,height-500,toolbarzyes,location2no,status-no, 
menubar=no,scrollbars=yes,resizable=yes')"> 
#159 <INPUT NAME-"CLEAR" TYPE="RESET" VALUE="UNDO"  class="formbutton" TITLE="Clear last input" 
onClick="window.document.search_form.bookmark_create.value='0';window.document.search_form.target=";"> <INPUT 
NAME="CLEAR" TYPE=BUTTON VALUE="CLEAR" class="formbutton" TITLE="Clear the form" 
onClick="window.document.search_form.bookmark_create.value='0';window.document.search_form.target="; 
submit_again()">\ 
</TD></TR></TABLE> <!-- --> 
#160 </FORM> 
#161 
#162 
#163 
#164 
#165 <HR> 
: HR above and below Index selection 
11166 
11167 
11168 
11169 
54170 This line should generate a bookmark page 
#170 «H2»«Center» SAVE QUERY «/Center» «/H2» \ 
<BR>The link below has coded the query form with your query. You can save this query just as a bookmark to reuse it in 
the future. To do so: «UL» 
«LI»with the right mouse button click on the link "Save Query" below; 
<Ll>select the option "Add bookmark" in case of Netscape, or "Add to Favorites" in case of MS Internet Explorer; V 
<Ll>use the option "Edit bookmarks" (if Netscape) or "Favorites" (if Internet Explorer) in order to store the bookmark in a 
folder and properly name it; \ 
<Ll>whenever needed, find in your Bookmarks or Favorites the link and activate your query page.^ 
«/UL» «BR» «A HREF="/cgi-bin/isisSw?search_type=ef_back&de_back=%s">Save Query</A> as a bookmark 
#171 
#172 
#173 
#174 
#175 
#176 
#177 
#178 
#179 
#180 <TABLE COLS-1 WIDTH="90%" class='help'>\ 
<TR> \ 
<I D><B><U>Tips</U></B> \ 
<BR> - Use UNDO to delete last input and CLEAR to empty the form.\ 
<BR> - Leave the collection field blank to search through ALL collections.\ 
<BR> - Click available in Full Text box if you want ONLY those documents available ^ 
in full text. 
#181 «BR» - If you do not know what to enter as a search term, press the "List" button. 
<BR>&nbsp; This will give you a list of keywords where you can select relevant terms.^ 
<BR> - When entering more then one search terms in a field, 
separate each term with a semicolon (;). \ 
<BR>&nbsp; The semicolon is interpreted by the system according to the choice V 
of boolean operator.^ 
«BR» - You may also use the ISIS logical operators:\ 
<BR>&nbsp + for OR\ 
<BR>&nbsp * for AND\ 
<BR>&nbsp ^ for AND NOT^ 
<BR> - If the field contains ISIS boolean operators the boolean selection\ 
does not change them. 
<BR> - If the box "Exact match of words" is marked, you can also 
use the $ mask for root searching. 
<P><B><A HREF="/libcat/help/examples.html" TARGET="empty" ^ 
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onClick="window.open(‘/libcat/help/examples.html', ‘Help’, 
'width=610,height=400,toolbar=yes,location=no,status=no,menubar=no,scrollbars=yes,resizable=yes'); return false">\ 
See also examples</A></B></TD> 
#182 </TR> 
#183 </TABLE> 
#184 
#185 
#186 
#187 </BODY> 
#188 
#189 
#190 <!-- Generic HTML v 3.0 20/02/1999 tra template v1.0 isis3w -->\ 
<!-- Document end -->\ 
</HTML> 


#191 «CENTER» 
<H2><BLINK> Backend (ISIS) error: %s </H2></BLINK>\ 
</CENTER> 

#192 «CENTER» 
<H2><BLINK> Backend timeout error </H2></BLINK>\ 
</CENTER> 

#193 «CENTER» 
<H2><BLINK> Malformed query</H2></BLINK>\ 
</CENTER> 

#194 «CENTER» 
<H2><BLINK> No HTP template or error in template </H2></BLINK>\ 
</CENTER> 

#195 «CENTER» 
<H2><BLINK> Language not supported </H2></BLINK>\ 
</CENTER> 

#196 «CENTER» 
<H2><BLINK> Undefined error </H2></BLINK>\ 
</CENTER> 

#197 «CENTER» 
<H2><BLINK> Undefined error </H2></BLINK>\ 
</CENTER> 

#198 «CENTER» 
<H2><BLINK> Undefined error </H2></BLINK>\ 
</CENTER> 

#199 «CENTER» 
<H2><BLINK> Undefined error </H2></BLINK>\ 
</CENTER> 


15. 2. Sample HTP for the FAOBIB data entry application 


E_forms.htp 


7 287 290 291 9 
#0 
#1 «IDOCTYPE HTML PUBLIC "-//IETF/DTD HTML 3.0//EN">\ 
«HTML» 
<!-- Generic HTML v 3.0 20/02/1999 tra template v1.0 isis3w --> 
#2 <HEAD><META http-equiv2"Content- Type" content="text/html; charset=iso-8859-1"> 
#3 <TITLE>LIBCAT Data Entry</TITLE> V 
<link rel="stylesheet" type="text/css" href="/libcat/main.css"> 


#8 <BODY> 
#9 
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#10 <P> 

#11 Please choose worksheet: 

#12 <P> 

#13 <UL> 

#14 

; repeated line 

#15 <LI><A HREF="/cgi- 
bin/isisSw.exe?database=@database@&search_type=@search_type@&lang=eng&de_worksheet=“%s&de_define_default 
s=@de_ define _defaults@" TARGET="display">%s</A> 
#16 

#17 </UL> 

#18 


#20 <FORM METHOD=POST ACTION-"/cgi-bin/isis3w.exe" ENCT YPE="application/x-www/form-urlencoded" 
NAME="entry_form"> 

#21 <INPUT TYPE="HIDDEN" NAME-"database" VALUE="@database@"> 

#22 <INPUT TYPE="HIDDEN" NAME-"table" VALUE="@table@"><INPUT TYPE="HIDDEN" NAME="de_mail_pft" 
VALUE="@de_mail_pft@"> 

#23 <INPUT TYPE="HIDDEN" NAME="lang" VALUE="@lang@"><INPUT TYPE="HIDDEN" NAME="de_goto_page" 
VALUE="0"> 


#24 <INPUT TYPE="HIDDEN" NAME-"page header" VALUE="@page_header@"><INPUT TYPE="HIDDEN" 
NAME="de_level" VALUE="@de_level@"> 

#25 <INPUT TYPE="HIDDEN" NAME="de_ define defaults" VALUE="@de_define_defaults@"><INPUT TYPE="HIDDEN" 
NAME-"de function" VALUE="@de_function@"><INPUT TYPE="HIDDEN" NAME="rec_id" VALUE="@rec_id@"> 

#26 

#27 <INPUT TYPE="HIDDEN" NAME="search_type" VALUE="%s"> 

#28 

#29 <INPUT TYPE="HIDDEN" NAME="%s" VALUE="%s"> 


#30 <TABLE WIDTH="90%" CELLSPACING=0 CELLPADDING=0 BORDER=0> 

#31 <TR> 

#32 «TD COLSPAN=2 class="maincolor" ALIGN="LEFT"><FONT SIZE="-1" 
FACE="Arial,Helvetica"><B>&nbsp;%s</B></FONT><BR>&nbsp;</TD> 

#33 «TD class="maincolor"><H2>&nbsp;</H2></TD> 

#33 

#34 <TD class="maincolor" ALIGN="RIGHT" VALIGN=TOP><FONT SIZE="-1" FACE="Arial,Helvetica"><B>Page %а of 
%d&nbsp;</B></FONT></TD> 

#35 «/TR»«TR2«TD COLSPAN=3>&nbsp;</TR> 


#36 <TR> 

#37 <TD><TD COLSPAN=2 NOWRAP ALIGN=RIGHT><SMALL> 

#38 <INPUT NAME="PREVIOUS PAGE" TYPE="SUBMIT" VALUE="PREVIOUS PAGE" 
onClick="window.document.entry_form.search_type.value='ef_page_prev';">&nbsp; 

#39 <INPUT NAME="NEXT PAGE" TYPE="SUBMIT" VALUE="NEXT PAGE" 
onClick="window.document.entry_form.search_type.value='ef_page_next';">&nbsp; 

#40 <INPUT NAME="SUBMIT" TYPE="SUBMIT" VALUE="SAVE RECORD" 
onClick="window.document.entry_form.search_type.value='ef_submit';"></SMALL></TD> 
#41 </TR></TABLE> 


#42 <P> <CENTER><TABLE CELLSPACING=0 CELLPADDING=0 BORDER=0 > 

#43 

#44 <TD><SMALL><INPUT TYPE="SUBMIT" NAME="%s" VALUE="ADD GROUP" 
onClick="window.document.entry_form.search_type.value='ef_field_add_new';"></SMALL></TD> 
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#45 <INPUT NAME-" %а " TYPE="SUBMIT" VALUE=" 96d " 
OnClick="window.document.entry_form.search_type.value='ef_page_next';window.document.entry_form.de_goto_page.va 
lue='%d';">&nbsp; 

#46 

#47 </TABLE></CENTER> 

#48 </TABLE></FORM> 

#49 </FORM> 


#51 

; description 

#52 <TD ALIGN="RIGHT" class="maincolor"><FONT FACE-"Arial,Helvetica" SIZE="- 
2"><B>%S</B></FONT></TD><TD>&nbsp;</TD> 

; Input 

#53 <TD NOWRAP class="maincolor" ><INPUT TYPE="TEXT" NAME="%s" SIZE=%d MAXLENGTH=%d 
VALUE="%s"></TD><TD>&nbsp;</TD> 

#54 

; list button for list 

#55 

#55 <TD><SMALL><INPUT TYPE="SUBMIT" NAME="%s" VALUE="LIST"></SMALL></TD><TD>&nbsp;</TD> 
; list button for browse 

#56 «TD class="maincolor"><SMALL><INPUT TYPE="SUBMIT" NAME="%s" VALUE="BROWSE" 
onClick="window.document.entry_form.search_type.value='ef_browse';"></SMALL></TD><TD>&nbsp;</TD> 
#57 

; add new button 

#58 <TD><SMALL><INPUT TYPE="SUBMIT" NAME="%s" VALUE="ADD NEW" 
onClick="window.document.entry_form.search_type.value='ef_field_add_new';"></SMALL></TD> 


#59 </TR><TR><TD>&nbsp;</TD></TR> 


; description 

#62 <TD ALIGN="RIGHT" class="maincolor"><FONT FACE-"Arial,Helvetica" SIZE="- 
2"><B>%S</B></FONT></TD><TD>&nbsp;</TD> 

; Input 

#63 <TD NOWRAP class="maincolor"><TEXTAREA NAME="%s" ROWS=%d COLS=%d MAXLENGTH=%d 
VALUE="%s" WRAP>%S</TEXTAREA></TD><TD>&nbsp;</TD> 

#64 

; list button for list 

#65 <TD><SMALL><INPUT TYPE="SUBMIT" NAME="%s" VALUE="LIST"></SMALL></TD><TD>&nbsp;</TD> 
; list button for browse 

#66 <TD class="maincolor"><SMALL><INPUT TYPE="SUBMIT" NAME="%s" VALUE="BROWSE" 
onClick="window.document.entry_form.search_type.value='ef_browse';"></SMALL></TD><TD>&nbsp;</TD> 
#67 

; add new button 

#68 <TD><SMALL><INPUT TYPE="SUBMIT" NAME="%s" VALUE="ADD NEW" 
onClick="window.document.entry_form.search_type.value='ef_field_add_new';"></SMALL></TD> 

#69 </TR><TR><TD>&nbsp;</TD></TR> 


#71 

; description 

#72 <TD ALIGN="RIGHT" class="maincolor"><FONT FACE="Arial,Helvetica" SIZE="- 
2"><B>%S</B></FONT></TD><TD>&nbsp;</TD> 

; input 

#73 <TD class="maincolor"><SELECT NAME="%s" SIZE=%d> 

#74 

#75 «OPTION VALUE="%s" %sS>%s 

#76 

#77 </SELECT></TD><TD>&nbsp;</TD> 
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; add new button 

#78 <TD><SMALL><INPUT TYPE="SUBMIT" NAME="%s" VALUE="ADD NEW" 
onClick="window.document.entry_form.search_type.value='ef_field_add_new';"></SMALL></TD> 
#79 </TR><TR><TD>&nbsp;</TD></TR> 


#81 

; description 

#82 «TD ALIGN="RIGHT"><FONT FACE-"Arial,Helvetica" SIZE="-2"><B>%s</B></FONT></TD><TD>&nbsp;</TD> 
; input 

#83 <TD><SELECT MULTIPLE NAME="%s" SIZE=%d> 

#84 

#85 «OPTION VALUE="%s" %sS>%S 

#86 

#87 </SELECT></TD><TD>&nbsp;</TD> 

; add new button 

#88 <TD><SMALL><INPUT TYPE="SUBMIT" NAME="%s" VALUE="ADD NEW" 
onClick="window.document.entry_form.search_type.value='ef_field_add_new';"></SMALL></TD> 
#89 </TR><TR><TD>&nbsp;</TD></TR> 


#91 

; description 

#92 <TD ALIGN="RIGHT" class="maincolor"><FONT FACE-"Arial,Helvetica" SIZE="- 
2"><B>%S</B></FONT></TD><TD>&nbsp;</TD> 

; input 

#93 <TD><TABLE class="maincolor" BORDER=0><TR> 

; repeat 

#94 <TD VALIGN=TOP> 

#94 <TD NOWRAP VALIGN=TOP> 

#95 <INPUT TYPE="CHECKBOX" NAME="%s" VALUE="%s" %S><B><FONT FACE-"Arial,Helvetica" SIZE="-2">%s</B> 
&nbsp;<BR> 

#96 </TD> 

#97 </TR></TABLE></TD> 

; add new button 

#98 <TD><SMALL><INPUT TYPE="SUBMIT" NAME="%s" VALUE="ADD NEW" 
onClick="window.document.entry_form.search_type.value='ef_field_add_new';"></SMALL></TD> 
#99 </TR><TR><TD>&nbsp;</TD></TR> 


#100 <TR> 

#101 

; description 

#102 <TD ALIGN="RIGHT" class="maincolor"><FONT FACE="Arial,Helvetica" SIZE="- 
2"><B>%S</B></FONT></TD><TD>&nbsp;</TD> 

; Input 

#103 <TD><TABLE class="maincolor" BORDER=0><TR> 

#104 <TD VALIGN=TOP> 

#104 <TD NOWRAP VALIGN=TOP> 

; repeat 

#105 <INPUT TYPE="RADIO" NAME="%s" VALUE="%s" %s ><B><FONT FACE="Arial,Helvetica" SIZE="- 
2">%S</B><BR> 

#106 </TD> 

#107 </table></TD><TD>&nbsp;</TD> 

; add new button 

#108 <TD><SMALL><INPUT TYPE="SUBMIT" NAME="%s" VALUE="ADD NEW" 
onClick="window.document.entry_form.search_type.value='ef_field_add_new';"></SMALL></TD> 
#109 </TR><TR><TD>&nbsp;</TD></TR> 
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1110 

#111 <TR> 

#112 

#113 

#114 <TD COLSPAN=5>%s</TD> 

#115 

#116 

#117 

#118 </TR><TR><TD>&nbsp;</TD></TR> 
#119 


#120 <BODY>\ 

<TABLE WIDTH="100%" CELLSPACING=0 CELLPADDING=0 BORDER=0>\ 
«TRA 

«TD class="maincolor" ALIGN="LEFT"><FONT SIZE="+1" FACE="Arial,Helvetica"><B>&nbsp;Data Entry Results - Delete 
Record</B></FONT></TD>\ 

</TR></TABLE> 

#121 

#122 <P> 

#123 <H3>Record has been removed.</H3> 

#124 

#125 


#130 «BODY» 

<TABLE WIDTH="100%" CELLSPACING=0 CELLPADDING=0 BORDER=0>\ 
«IR» 

«TD class="maincolor" ALIGN="LEFT"><FONT SIZE="+1" FACE-"Arial,Helvetica"» «B» &nbsp;Data Entry Results - Delete 
Record«/B» «/FONT»«/TD»* 

</TR></TABLE> 

#131 <P><H4>Errors:</H4> 

#132 <P><H4>Warnings:</H4> 

#133 <UL> 

#134 

#135 «Ll» %s 

#136 

#137 

#138 </UL> 

#139 

#140 <P> 

#141 

#142 «A HREF="/cgi- 
bin/isisw.exe?rec_id=@rec_id@&de_worksheet=@de_worksheet@&database=@database@&search_type=@search_ty 
pe@&lang=@lang@&de_force=1">Click here to delete record anyway</A> 
#143 

#144 

#145 


#150 «BODY» 
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«TABLE WIDTH="100%" CELLSPACING=0 CELLPADDING=0 BORDER=0>\ 

<IR>\ 

«TD class="maincolor" ALIGN="LEFT"><FONT SIZE="+1" FACE="Arial,Helvetica"><B>&nbsp;Data Entry Results - 
Add/Modify Record</B></FONT></TD>\ 

</TR></TABLE> 

#151 <P><H4>Errors:</H4> 

#152 <P><H4>Warnings:</H4> 

#153 <UL> 

#154 

#155 <LI> %s 

#156 

#157 

#158 </UL> 

#159 

#160 <P> 

#161 

#162 «A HREF="/cgi- 

bin/isis8w.exe?rec_id=@rec_id@&de_worksheet=@de_worksheet@ &database=@database@&search_type=@search_ty 
pe@&lang=@lang@&de_function=@de_function@&de_define_defaults=@de_define_defaults@&de_level=@de_level@ 
&de_magic=@de_magic@&de_page=@de_page@&de_force=1&de_mail_pft-@de_mail_pft@">Click here to add/modify 
record anyway</A> 

#163 

#164 

#165 

#166 


#170 <BODY>\ 

<TABLE WIDTH="100%" CELLSPACING=0 CELLPADDING=0 BORDER=0>\ 

<TR>\ 

«TD class="maincolor" ALIGN="LEFT"><FONT SIZE="+1" FACE="Arial, Helvetica"><B>&nbsp;Data Entry Results - 
Add/Modify Record</B></FONT></TD>\ 

</TR></TABLE> 

#171 

#172 <P> 

#173 <H3>Record has been saved.</H3> 

#174 


#180 <BODY> 

#181 <TABLE WIDTH="50%" CELLSPACING=0 CELLPADING=0 BORDER=0>\ 

«TR class="maincolor"><TD ALIGN="LEFT" WIDTH="100%">\ 

<FONT FACE="Arial, Helvetica" SIZE=+2><B>&nbsp;Login</B></FONT>\ 

</TD></TR>\ 

</TABLE> 

#182 <P><FORM METHOD=POST ACTION="/cgi-bin/isisSw.exe" ENCTYPE-"application/x-www/form-urlencoded" 
NAME="de_login"> 

#183 <INPUT TYPE="HIDDEN" NAME="lang" VALUE="@lang@"> 

#184 <INPUT TYPE="HIDDEN" NAME-"search type" VALUE="ef_submit_login"> 

#185 

#186 <TABLE>\ 

<TR><TD><FONT FACE="Arial, Helvetica">Username:</FONT></TD>\ 

<TD><INPUT TYPE="TEXT" NAME="de_user" VALUE="" SIZE=40 MAXLENGTH=40 style="font-family: Arial; font-size: 
10pt;"></TD></TR>\ 

<TR><TD><FONT FACE="Arial, Helvetica">Password:</FONT></TD>\ 

<TD><INPUT TYPE="PASSWORD" NAME="de_pass" VALUE-2"" SIZE=40 MAXLENGTH=40 style="font-family: Arial; 
font-size: 10pt;"></TD></TR>\ 

</TABLE>\ 

</P><P><TABLE WIDTH="50%" CELLSPACING=0 CELLPADING=0 BORDER=0> \ 
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«TD WIDTH="100%" ALIGN="center" class="maincolor"><INPUT TYPE="SUBMIT" NAME="login" VALUE="LOGIN" 
class="formbutton"></TD></TABLE> 
#187 
#188 </FORM> 
#189 </HTML> 


#190 <BODY> 

#191 <TABLE WIDTH="100%" CELLSPACING=0 CELLPADING=0 BORDER=0> 

#192 <TR><TD ALIGN="LEFT" class-"maincolor" WIDTH="100%"><FONT FACE-"Arial, Helvetica" 
SIZE=+2><B>&nbsp;Data Entry</B></FONT></TD></TR></TABLE><P> 

#195 <FONT SIZE=+1>User @de_user@ logged in.</FONT> 

#199 </HTML> 


#200 <BODY> 

#201 <TABLE WIDTH="100%" CELLSPACING=0 CELLPADING=0 BORDER=0> 

#202 <TR><TD ALIGN="LEFT" class-"maincolor" WIDTH="100%"><FONT FACE-"Arial, Helvetica" 
SIZE=+2><B>&nbsp;Data Entry</B></FONT></TD></TR></TABLE><P> 

#205 <FONT SIZE=+1>User @de_user@ logged out.</FONT> 

#209 </HTML> 


#220 <BODY>\ 

<TABLE WIDTH="100%" CELLSPACING=0 CELLPADDING=0 BORDER=0>\ 

«TRA 

«TD class="maincolor" ALIGN="LEFT"><FONT SIZE="+1" FACE-"Arial,Helvetica"» «B» &nbsp;Data Entry Results - Define 
Defaults</B></FONT></TD>\ 

</TR></TABLE> 

#221 

#222 <P> 

#223 <H3>Defaults has been saved.</H3> 

#224 


#240 <TR> 

#241 

; description 

#242 <TD ALIGN="RIGHT" class="maincolor"><FONT COLOR=BROWN SIZE=-2 FACE="Arial,Helvetica" SIZE="- 
1"><B>%S</B></FONT></TD><TD>&nbsp;</TD> 

; input 

#243 <TD NOWRAP classz"maincolor" ><INPUT TYPE="HIDDEN" NAME="%s" VALUE="%s"><FONT 
FACE="Arial,Helvetica" SIZE="-1"><B>%S</B></FONT></TD><TD>&nbsp;</TD> 

#244 

; list button for list 

#245 

; list button for browse 

#246 «TD class="maincolor"><SMALL><INPUT TYPEZ"SUBMIT" NAME="%s" VALUE="BROWSE" 
onClick="window.document.entry_form.search_type.value='ef_browse';"></SMALL></TD><TD>&nbsp;</TD> 
#247 

; add new button 

#248 <TD><SMALL><INPUT TYPE="SUBMIT" NAME="%s" VALUE="ADD NEW" 
onClick="window.document.entry_form.search_type.value='ef_field_add_new’;"></SMALL></TD> 


#249 </TR><TR><TD>&nbsp;</TD></TR> 
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#250 <TABLE WIDTH="90%" CELLSPACING=0 CELLPADDING=0 BORDER=0> 

#251 <TR> 

#252 <TD><TD COLSPAN=2 NOWRAP ALIGN=RIGHT><SMALL> 

#253 <INPUT NAME="PREVIOUS PAGE" TYPE="SUBMIT" VALUE="PREVIOUS PAGE" 
onClick="window.document.entry_form.search_type.value='ef_page_prev';">&nbsp; 

#254 <INPUT NAME="NEXT PAGE" TYPE="SUBMIT" VALUE="NEXT PAGE" 
onClick="window.document.entry_form.search_type.value='ef_page_next';">&nbsp; 

#255 <INPUT NAME="SUBMIT" TYPE="SUBMIT" VALUE="SAVE RECORD" 
onClick="window.document.entry_form.search_type.value='ef_submit';"></SMALL></TD> 
#256 </TR> 

#257 «TR» 


#258 «TD COLSPAN-3 class="maincolor"><FONT SIZE="+1" FACE="Arial,Helvetica"><B>&nbsp;</B></FONT></TD> 


#259 </TR> 
#260 </TABLE> 


#290 «!-- Generic HTML v 3.0 20/02/1999 tra template v1.0 isis3w -->\ 

<!-- Document end -->\ 

</HTML> 

#291 «CENTER» 
<H2><BLINK> Backend (ISIS) error: %s </H2></BLINK>\ 
</CENTER> 

#292 «CENTER» 
<H2><BLINK> Backend timeout error </H2></BLINK>\ 
</CENTER> 

#293 «CENTER» 
<H2><BLINK> Malformed query</H2></BLINK>\ 
</CENTER> 

#294 «CENTER» 
<H2><BLINK> No HTP template or error in template </H2></BLINK>\ 
</CENTER> 

#295 «CENTER» 
<H2><BLINK> Language not supported </H2></BLINK>\ 
</CENTER> 

#296 «CENTER» 
<H2><BLINK> Undefined error </H2></BLINK>\ 
</CENTER> 

#297 «CENTER» 
<H2><BLINK> Undefined error </H2></BLINK>\ 
</CENTER> 

#298 «CENTER» 
<H2><BLINK> Undefined error </H2></BLINK>\ 
</CENTER> 

#299 «CENTER» 
<H2><BLINK> Undefined error </H2></BLINK>\ 
</CENTER> 
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